Microsoft XML SDK 2.6 - XML Reference

IXMLDOMEntity::publicId Method

IXMLDOMEntity::get_publicId Method

Contains the public identifier.

Visual Basic Syntax

strValue = oXMLDOMEntity.publicId

C/C++ Syntax

HRESULT get_publicId(
    BSTR *publicID);

Parameters

publicID [out]
Public identifier associated with the entity, if specified. If the public identifier is not specified, contains the empty string.

C/C++ Return Values

S_OK
Value returned if successful.
S_FALSE
Value returned if no public ID is specified.
E_INVALIDARG
Value returned if publicID is Null.

Example

IXMLDOMEntity *pIXMLDOMEntity = NULL;
VARIANT varName ;
HRESULT hr;

try
{
   // See help on IXMLDOMEntity::get_notationName method for definition of
   // the GetFirstEntity() method.
   pIXMLDOMEntity = GetFirstEntity();

   if(pIXMLDOMEntity)
   {
      hr = pIXMLDOMEntity->get_publicId(&varName);
      if(SUCCEEDED(hr))
         ::MessageBox(NULL, _bstr_t(varName), _T("Public ID"), MB_OK);
      pIXMLDOMEntity->Release();
   }
}
catch(...)
{
   if(pIXMLDOMEntity)
      pIXMLDOMEntity->Release();
   DisplayErrorToUser();
}

See Also

IXMLDOMEntity Interface