name Property (IXMLDOMDocumentType)

 

Contains the name of the document type.

Script Syntax

strValue = oXMLDOMDocumentType.name;  

Visual Basic Syntax

strValue = oXMLDOMDocumentType.name  

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.

Versioning

Implemented in:

MSXML 3.0, MSXML 6.0

Applies to

IXMLDOMDocumentType