Share via

WsMarkHeaderAsUnderstood 函数 (webservices.h)

  • 项目

此函数将标头标记为应用程序“已理解”。

标头集是可扩展的，发送方无法访问接收方的消息同化。 此函数是接收应用程序方法，用于使发送方知道已读取和理解接收的标头。

注意 仅当应用程序收到指示必须理解标头的消息，并且它未使用 WsGetHeader 或 WsGetCustomHeader 获取标头时，才应使用此函数。

WS_MESSAGE_STATE必须位于 设置为 WS_MESSAGE_STATE_READING。 看到。WsCheckMustUnderstandHeaders 了解详细信息。

 

语法

HRESULT WsMarkHeaderAsUnderstood(
  [in]           WS_MESSAGE                 *message,
  [in]           const WS_XML_NODE_POSITION *headerPosition,
  [in, optional] WS_ERROR                   *error
);

参数

[in] message

指向 Message 对象的指针，其中包含要标记的标头。

[in] headerPosition

指向标头元素在 XML 标头段中的位置的指针。

[in, optional] error

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

返回值

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

返回代码 说明
WS_E_INVALID_OPERATION
 消息未处于正确状态。
E_INVALIDARG
 一个或多个参数无效。
E_OUTOFMEMORY
 内存不足。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

当应用程序使用 XML 读取器读取标头时，它应获取标头元素 WS_XML_NODE_POSITION 并将其传递给此函数。 有关如何获取WS_XML_NODE_POSITION，请参阅 WsGetReaderPosition。

要求

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