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