WsMarkHeaderAsUnderstood, fonction (webservices.h)

Cette fonction marque un en-tête comme « compris » par l’application.

L’ensemble d’en-têtes est extensible et l’assimilation des messages par le destinataire n’est pas accessible par l’expéditeur. Cette fonction est la méthode d’applications de réception permettant de faire savoir à l’expéditeur que l’en-tête reçu a été lu et compris.

Syntaxe

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

Paramètres

[in] message

Pointeur vers l’objet Message avec l’en-tête à marquer.

[in] headerPosition

Pointeur vers la position de l’élément header dans le segment d’en-tête XML.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

Lorsque l’application lit l’en-tête à l’aide d’un lecteur XML, elle doit obtenir une WS_XML_NODE_POSITION de l’élément header et la passer à cette fonction. Pour savoir comment obtenir un WS_XML_NODE_POSITION, consultez WsGetReaderPosition.

Configuration requise