WsRemoveMappedHeader 函数 (webservices.h)

从消息中删除映射标头的所有实例。

语法

HRESULT WsRemoveMappedHeader(
  [in]           WS_MESSAGE          *message,
  [in]           const WS_XML_STRING *headerName,
  [in, optional] WS_ERROR            *error
);

参数

[in] message

要设置标头的消息。

消息可以处于任何状态,但 WS_MESSAGE_STATE_EMPTY

[in] headerName

要删除的映射标头的名称。

[in, optional] error

指定在函数失败时应存储其他错误信息的位置。

返回值

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

返回代码 说明
E_INVALIDARG
一个或多个参数不正确。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

邮件可能包含不属于邮件信封的其他特定于传输的信息。 此特定于传输的信息可以编程方式作为 Message 对象的标头公开。 此函数用于从消息对象中删除映射的标头。 这可由自定义通道实现用于在发送消息之前删除映射的标头。

要求

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