Funzione WsInitializeMessage (webservices.h)

Articolo
03/03/2024

Questa funzione inizializza le intestazioni per il messaggio in preparazione per l'elaborazione. Dopo l'inizializzazione di un messaggio, un'applicazione può aggiungere intestazioni aggiuntive. In caso di esito positivo, il messaggio è in stato WS_MESSAGE_STATE_INITIALIZED . Se la funzione ha esito negativo, non si verificano transizioni di stato.

Sintassi

HRESULT WsInitializeMessage(
  [in]           WS_MESSAGE                *message,
  [in]           WS_MESSAGE_INITIALIZATION initialization,
  [in, optional] WS_MESSAGE                *sourceMessage,
  [in, optional] WS_ERROR                  *error
);

Parametri

[in] message

Puntatore all'oggetto Message da inizializzare. Il messaggio deve essere un'istanza dell'oggetto WS_MESSAGE valida restituita da WsCreateMessage o WsCreateMessageForChannel e potrebbe non essere NULL.

[in] initialization

Definisce l'inizializzazione del messaggio.

Nota Se il valore di inizializzazione è impostato su WS_REPLY_MESSAGE o WS_FAULT_MESSAGE il messaggio viene risolto automaticamente.

[in, optional] sourceMessage

Puntatore a un oggetto message utilizzato per inizializzare il parametro del messaggio . Questo valore deve essere NULL a meno che il parametro di inizializzazione non abbia il valore di WS_DUPLICATE_MESSAGE, WS_REPLY_MESSAGE o WS_FAULT_MESSAGE.

[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
E_OUTOFMEMORY	Memoria insufficiente.
E_INVALIDARG	Uno o più argomenti non sono validi.
Altri errori	Questa funzione può restituire altri errori non elencati sopra.

Commenti

Il mittente iniziale di un messaggio deve aggiungere un'intestazione di azione al messaggio usando WsSetHeader.

Questa API deve essere chiamata prima che WsWriteEnvelopeStart o WsWriteMessageStart venga chiamata per il messaggio.

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