Microsoft XML Core Services (MSXML) 5.0 for Microsoft Office - SAX2 Reference

notationDecl Method

Receives notification of a notation declaration event.

[Visual Basic]

If necessary, the application can record the notation for later reference. At least one of the PublicId or SystemId values must be available. If a system entity is present and it is a URL, the reader must resolve it before passing it to the application through the notationDecl method. There is no guarantee that the notation declaration will be reported before any unparsed entities that use it.

Implementation Syntax

Sub notationDecl(strName As String, strPublicId As String,_
strSystemId As String)

Parameters

strName
The notation's name.
strPublicId
The notation's public identifier or Null (if none was given).
strSystemId
The notation's system identifier (required).

Return Value

If failed, the DTDHandler raises a trappable error.

[C/C++]

It is the responsibility of the application to record the notation for later reference. If a system identifier is present and it is a URL, the reader must resolve it fully before passing it to the application.

Syntax

HRESULT notationDecl(
   [in] const wchar_t * pwchName, 
   [in] int cchName, 
   [in] const wchar_t * pwchPublicId, 
   [in] int cchPublicId
   [in] const wchar_t * pwchSystemId
   [in] int cchSystemId);

Parameters

pwchName [in]
The notation's name.
cchName [in]
The length of the notation.
pwchPublicId [in]
The notation's public identifier or Null (if none was given).
cchPublicId [in]
The length of the public identifier.
pwchSystemId [in]
The notation's system identifier or Null (if none was given).
cchSystemId [in]
The length of the system identifier.

Return Values

S_OK
The value returned if no errors occur.
E_FAIL
The value returned if the parse should be aborted.

To view reference information for Visual Basic or C/C++ only, click the Language Filter button Language Filter in the upper-left corner of the page.

See Also

unparsedEntityDecl Method

Applies to: ISAXDTDHandler/IVBSAXDTDHandler Interface