WsSetInput 函数 (webservices.h)

设置 XML 读取器的编码和输入源。 这些设置替代创建读者时所做的设置。

注意 如果编码和输入均为 NULL ，则读取器将像定位在空 XML 文档的末尾一样运行。

 

语法

HRESULT WsSetInput(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
  [in, optional] const WS_XML_READER_INPUT    *input,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in, optional] WS_ERROR                     *error
);

参数

[in] reader

指向将为其设置输入的 WS_XML_READER 对象的指针。

[in, optional] encoding

对描述输入字节格式的编码值的 。 此值应为以下项之一：

• WS_XML_READER_TEXT_ENCODING
• WS_XML_READER_BINARY_ENCODING
• WS_XML_READER_MTOM_ENCODING

[in, optional] input

指向指示读取器类型的 WS_XML_READER_INPUT 结构的指针。

properties

可选 Reader 属性的数组引用。

[in] propertyCount

属性数。

[in, optional] error

指向 WS_ERROR 对象的指针，如果函数失败，应存储有关错误的其他信息。

返回值

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

在 XML 读取器上使用 WsSetInput 时，读取器将以仅向前方式运行，并且无法使用 WsGetReaderPosition、 WsSetReaderPosition 和 WsMoveReader 函数。

要求

要求	值
最低受支持的客户端	Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台	Windows
标头	webservices.h
Library	WebServices.lib
DLL	WebServices.dll