WsGetHeaderAttributes 函数 (webservices.h)

  • 项目

此函数使用读取器所在的标头元素中的 WS_HEADER_ATTRIBUTES 填充 ULONG 参数。 消息的信封版本用于确定要返回的属性。

语法

HRESULT WsGetHeaderAttributes(
  [in]           WS_MESSAGE    *message,
  [in]           WS_XML_READER *reader,
  [out]          ULONG         *headerAttributes,
  [in, optional] WS_ERROR      *error
);

参数

[in] message

指向包含要查询的消息 的WS_MESSAGE 结构的指针。 此信封版本的消息用于确定哪些属性匹配。 消息可以处于除 WS_MESSAGE_STATE_EMPTY之外的任何状态。

[in] reader

指向要查询的读取器的指针。 这必须WS_XML_READER从 WsCreateReader 返回的对象有效，并且不能为 NULL。

[out] headerAttributes

成功后，此指针引用的值设置为标头属性。

[in, optional] error

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

返回值

此函数可以返回其中一个值。

返回代码 说明
E_OUTOFMEMORY
 内存不足。
E_INVALIDARG
 一个或多个参数无效。
WS_E_INVALID_FORMAT
 输入数据未采用预期格式或没有预期值。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

假定读取器指向标头元素。 使用 XML 读取器 API 来适当地定位读取器。

要求

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