name Property (IXMLDOMDocumentType)

MSXML 5.0 SDK

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

name Property (IXMLDOMDocumentType)

Contains the name of the document type.

[Script]

Script Syntax

strValue = oXMLDOMDocumentType.name;
[Visual Basic]

Visual Basic Syntax

strValue = oXMLDOMDocumentType.name
[C/C++]

C/C++ Syntax

HRESULT get_name(
    BSTR *rootName);

Parameters

rootName [out, retval]
When specified, this corresponds to the single root element of the document tree.

C/C++ Return Values

S_OK
Value returned if successful.
S_FALSE
Value when returning Null.

Example

BOOL DOMDocGetDocType()
{
   BOOL bResult = FALSE;
   IXMLDOMDocumentType *pIXMLDOMDocumentType = NULL;
   IXMLDOMDocument *pIXMLDOMDocument = NULL;
   IXMLDOMDocumentType *pIXMLDOMDocumentType = NULL;
   BSTR bstrDTDName;
   HRESULT hr;

   try
   {
      // Create an instance of DOMDocument and initialize 
      // pIXMLDOMDocument.
      // Load/create an XML fragment.
      hr = pIXMLDOMDocument->get_doctype(&pIXMLDOMDocumentType);
      SUCCEEDED(hr) ? 0 : throw hr;

      if(pIXMLDOMDocumentType)
      {
         pIXMLDOMDocumentType->get_name(&bstrDTDName);
         ::MessageBox(NULL, bstrDTDName, _T("Doc Type"), MB_OK);
         bResult = TRUE;
         pIXMLDOMDocumentType->Release();
      }
   }
   catch(...)
   {
      if(pIXMLDOMDocumentType)
         pIXMLDOMDocumentType->Release();
      DisplayErrorToUser();
   }
   return bResult;
} 

Remarks

String. The property is read-only. When specified, this corresponds to the single root element of the document tree.

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

See Also

Applies to: IXMLDOMDocumentType