Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.



Sets the input source of the XML document to be parsed.

HRESULT SetInput ([in] IUnknown * pInput);  

The input stream to be parsed.

Returns S_OK if no error is generated.

The input source can be one of the following types:

  • A class derived from IStream or ISequentialStream. The reader will use defaults for all the additional properties of the input. IMalloc and base URI will be empty. There will be no use of alternative character set encoding.

  • IXmlReaderInput. The input is described by an instance of the IXmlReaderInput class. Using an instance of this class, the user can specify additional properties of the input (like alternative character set encoding and base URI). Use CreateXmlReaderInputWithEncodingCodePage or CreateXmlReaderInputWithEncodingName to get an instance of IXmlReaderInput.

  • NULL. This resets the input, releasing the previously set input object.

The following code sets the input source for a reader:

//Open read-only input stream  
if (FAILED(hr = SHCreateStreamOnFile(argv[1], STGM_READ, &pFileStream)))  
    wprintf(L"Error creating file reader, error is %08.8lx", hr);  
    return -1;  
if (FAILED(hr = CreateXmlReader(__uuidof(IXmlReader), (void**) &pReader, NULL)))  
    wprintf(L"Error creating xml reader, error is %08.8lx", hr);  
    return -1;  
if (FAILED(hr = pReader->SetProperty(XmlReaderProperty_DtdProcessing, DtdProcessing_Prohibit)))  
    wprintf(L"Error setting XmlReaderProperty_DtdProcessing, error is %08.8lx", hr);  
    return -1;  
if (FAILED(hr = pReader->SetInput(pFileStream)))  
    wprintf(L"Error setting input for reader, error is %08.8lx", hr);  
    return -1;  

Header: XmlLite.h

Library: XmlLite.lib

IXmlReader Methods

© 2017 Microsoft