Funzione WsMarkHeaderAsUnderstood (webservices.h)

Articolo
03/03/2024

Questa funzione contrassegna un'intestazione come "riconosciuta" dall'applicazione.

Il set di intestazioni è estendibile e l'assimilazione del messaggio dal ricevitore non è accessibile dal mittente. Questa funzione è il metodo di ricezione delle applicazioni per renderlo noto al mittente che l'intestazione ricevuta è stata letta e compresa.

Nota Questa funzione deve essere usata solo se l'applicazione riceve un messaggio che indica che l'intestazione deve essere compresa e non ha acquisito l'intestazione usando WsGetHeader o WsGetCustomHeader.

Il WS_MESSAGE_STATE deve essere impostato su WS_MESSAGE_STATE_READING. Vedere. WsCheckMustUnderstandHeaders per altre informazioni.

Sintassi

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

Parametri

[in] message

Puntatore all'oggetto Message con l'intestazione da contrassegnare.

[in] headerPosition

Puntatore alla posizione dell'elemento di intestazione all'interno del segmento di intestazione XML.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
WS_E_INVALID_OPERATION	Il messaggio non è nello stato corretto.
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Quando l'applicazione legge l'intestazione usando un lettore XML, deve ottenere un WS_XML_NODE_POSITION dell'elemento di intestazione e passarlo a questa funzione. Per informazioni su come ottenere un WS_XML_NODE_POSITION, vedere WsGetReaderPosition.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite