Compartir a través de

Función WsRemoveHeader (webservices.h)

  • Artículo

Quita el objeto WS_HEADER_TYPE estándar de un mensaje.

La función está diseñada para controlar los tipos de encabezados que aparecen una vez en el mensaje y están destinados al receptor final. Los encabezados destinados a un rol distinto del receptor final se omiten.

Para los tipos de encabezado definidos por la aplicación, use la función WsRemoveCustomHeader .

Sintaxis

HRESULT WsRemoveHeader(
  [in]           WS_MESSAGE     *message,
  [in]           WS_HEADER_TYPE headerType,
  [in, optional] WS_ERROR       *error
);

Parámetros

[in] message

Puntero al objeto Message con el encabezado que se va a quitar. El mensaje puede estar en cualquier estado excepto WS_MESSAGE_STATE_EMPTY.

[in] headerType

Indica el tipo de encabezado que se va a quitar.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error 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
WS_E_INVALID_FORMAT
 Hay varias instancias del tipo de encabezado presentes en el mensaje.
E_INVALIDARG
 Uno o varios de los parámetros son incorrectos.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Si existe un encabezado del tipo especificado en el mensaje que se quita. Si el encabezado no existe, no se realiza ninguna acción y la función se completa correctamente.

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