putDocumentLocator Method (C/C++)
Receives an interface for locating the origin of Simple API for XML (SAX) document events. The reader supplies a locator to the application by invoking this method before invoking any other methods in the ISAXContentHandler
interface. This locator allows the application to determine the end position of any document-related event, even if the parser is not reporting an error. Typically, the application uses this information to report its own errors (for example, if the character content does not match the business rules of the application).
Syntax
HRESULT putDocumentLocator( [in] ISAXLocator * pLocator);
Parameters
- pLocator [in]
- A pointer to a valid instance of the
ISAXLocator
interface.
Return Values
- S_OK
- The value returned if no errors occur.
- E_FAIL
- The value returned if the parse operation should be aborted.
Remarks
The information returned by the Locator
object can sometimes be insufficient for use with a search engine. The locator returns the correct information only during the invocation of events in this interface. The application should not attempt to use this method at any other time.
To view reference information for Visual Basic or C/C++ only, click the Language Filter button in the upper-left corner of the page.
See Also
ISAXLocator Interface | startDocument Method
Applies to: ISAXContentHandler Interface