Función WsRemoveMappedHeader (webservices.h)

  • Artículo

Quita todas las instancias de un encabezado asignado del mensaje.

Sintaxis

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

Parámetros

[in] message

Mensaje en el que se va a establecer el encabezado.

El mensaje puede estar en cualquier estado, pero WS_MESSAGE_STATE_EMPTY.

[in] headerName

Nombre del encabezado asignado que se va a quitar.

[in, optional] error

Especifica dónde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
E_INVALIDARG
 Uno o varios de los parámetros son incorrectos.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Un mensaje puede contener información adicional específica del transporte que no forma parte del sobre del mensaje. Esta información específica del transporte se puede exponer mediante programación como encabezados del objeto Message. Esta función se usa para quitar los encabezados asignados del objeto de mensaje. Esto se puede usar mediante una implementación de canal personalizada para quitar los encabezados asignados antes de enviar el mensaje.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll