WsRemoveCustomHeader function
Removes a custom header from the message. This function is designed to handle types of headers that appear once in the message and are targeted at the ultimate receiver. Headers targeted with a role other than ultimate receiver are ignored.
Syntax
HRESULT WINAPI WsRemoveCustomHeader( _In_ WS_MESSAGE **message, _In_ const WS_XML_STRING *headerName, _In_ const WS_XML_STRING *headerNs, _In_opt_ WS_ERROR* *error );
Parameters
- message [in]
-
A pointer to the Message object with the header to be removed. The message can be in any state except WS_MESSAGE_STATE_EMPTY.
- headerName [in]
-
A pointer to the WS_XML_STRING object that references the "local name" of the header element to be removed.
- headerNs [in]
-
A pointer to the WS_XML_STRING object that references the namespace of the header element to be removed.
- error [in, optional]
-
A pointer to a WS_ERROR object where additional information about the error should be stored if the function fails.
Return value
This function can return one of these values.
| Return code | Description |
|---|---|
|
There are multiple instances of the type of header present in the message. |
|
There was not enough memory available to serialize the header. |
|
One or more of the parameters are incorrect. |
|
This function may return other errors not listed above. |
Remarks
If a header of the given type exists in the message it is removed. If the header does not exist, the function takes no action and completes successfully.
Requirements
|
Minimum supported client | Windows 7 [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server | Windows Server 2008 R2 [desktop apps | Windows Store apps] |
|
Header |
|
|
Library |
|
|
DLL |
|