WriteStartDocument
Writes out the XML declaration with the version "1.0". The encoding attribute is determined by the implementation of IXmlWriterOutput. By default, the encoding is UTF-8.
Syntax
HRESULT WriteStartDocument (XmlStandalone standalone);
Arguments
standalone
If XmlStandalone_Omit does not write a standalone attribute in the XML declaration, one of the following occurs:
If
XmlStandalone_No, the writer writes standalone="no".If
XmlStandalone_Yes, the writer writes standalone="yes".
Return Value
Returns S_OK if no error is generated.
Remarks
The following shows the use of WriteStartDocument:
if (FAILED(hr = pWriter->WriteStartDocument(XmlStandalone_Omit)))
{
wprintf(L"Error, Method: WriteStartDocument, error is %08.8lx", hr);
return -1;
}
Caling WriteStartDocument is the same as calling WriteProcessingInstruction passing a name of "xml" as an argument. Therefore, a program cannot successfully call both WriteStartDocument and WriteProcessingInstruction passing the name "xml" for the same document. It is valid to call WriteStartDocument and WriteProcessingInstruction for processing instructions that have a name other than the name "xml".
For a more detailed example of theWriteStartDocument method, see Write an XML Document using XmlLite.
Requirements
Header: XmlLite.h
Library: XmlLite.lib