Compartir a través de

Función WsMarkHeaderAsUnderstood (webservices.h)

  • Artículo

Esta función marca un encabezado como "comprendido" por la aplicación.

El remitente no puede acceder al conjunto de encabezados y el remitente no puede acceder a la asimilación de mensajes. Esta función es el método de aplicaciones receptoras para que se sepa al remitente que se ha leído y comprendido el encabezado recibido.

Nota Esta función solo se debe usar si la aplicación recibe un mensaje que indica que se debe entender el encabezado y no adquirió el encabezado mediante WsGetHeader o WsGetCustomHeader.

El WS_MESSAGE_STATE debe estar en el conjunto en WS_MESSAGE_STATE_READING. Ver. WsCheckMustUnderstandHeaders para obtener más información.

 

Sintaxis

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

Parámetros

[in] message

Puntero al objeto Message con el encabezado que se va a marcar.

[in] headerPosition

Puntero a la posición del elemento de encabezado dentro del segmento de encabezado XML.

[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_OPERATION
 El mensaje no está en el estado correcto.
E_INVALIDARG
 Uno o más argumentos no son válidos.
E_OUTOFMEMORY
 Se quedó sin memoria.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Cuando la aplicación lee el encabezado mediante un lector XML, debe obtener un WS_XML_NODE_POSITION del elemento de encabezado y pasarlo a esta función. Consulte WsGetReaderPosition para obtener un WS_XML_NODE_POSITION.

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