Funzione WsInitializeMessage (webservices.h)

  • Articolo

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