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.

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.