Partager via


notationDecl Method

 

Receives notification of a notation declaration event.

Visual Basic 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++ 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.

Remarks

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.

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.

Versioning

Implemented in: MSXML 3.0 and later

Applies to

ISAXDTDHandler Interface

See Also

unparsedEntityDecl Method