Funzione WsSendReplyMessage (webservices.h)

  • Articolo

Invia un messaggio che è una risposta a un messaggio ricevuto.

Sintassi

HRESULT WsSendReplyMessage(
  [in]           WS_CHANNEL                   *channel,
  [in]           WS_MESSAGE                   *replyMessage,
  [in]           const WS_MESSAGE_DESCRIPTION *replyMessageDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *replyBodyValue,
  [in]           ULONG                        replyBodyValueSize,
  [in]           WS_MESSAGE                   *requestMessage,
  [in, optional] const WS_ASYNC_CONTEXT       *asyncContext,
  [in, optional] WS_ERROR                     *error
);

Parametri

[in] channel

Puntatore all'oggetto Channel in cui inviare il messaggio di risposta. Il puntatore deve fare riferimento a un oggetto WS_CHANNEL valido.

[in] replyMessage

Puntatore all'oggetto Message per l'invio della risposta. Il puntatore deve fare riferimento a un oggetto WS_MESSAGE valido.

Lo stato dell'oggetto messaggio deve essere impostato su WS_MESSAGE_STATE_EMPTY o WS_MESSAGE_STATE_INITIALIZED.

Nota Se viene fornito un messaggio inizializzato, deve essere inizializzato utilizzando WS_REPLY_MESSAGE o WS_FAULT_MESSAGE.
 

[in] replyMessageDescription

Puntatore a un oggetto WS_MESSAGE_DESCRIPTION . Il campo dell'azione di WS_MESSAGE_DESCRIPTION viene usato come intestazione dell'azione per il messaggio di risposta. Questo campo può essere NULL se non è necessaria alcuna azione.

Il campo bodyElementDescription del WS_MESSAGE_DESCRIPTION viene utilizzato per serializzare il corpo del messaggio di risposta. Questo campo può essere NULL se non si desidera alcun elemento body. Per informazioni su come viene usato bodyElementDescription per serializzare un valore, vedere WsWriteBody.

[in] writeOption

Determina se l'elemento body è obbligatorio e la modalità di allocazione del valore.

Per altre informazioni, vedere WS_WRITE_OPTION .

replyBodyValue

Puntatore void al valore da serializzare nel messaggio di risposta.

[in] replyBodyValueSize

Dimensione in byte del valore di risposta serializzato.

[in] requestMessage

Puntatore a un oggetto WS_MESSAGE che incapsula il testo del messaggio di richiesta. Viene usato per ottenere le informazioni di correlazione utilizzate per formulare il messaggio di risposta.

Nota Il messaggio può trovarsi in qualsiasi stato tranne WS_MESSAGE_STATE_EMPTY.
 

[in, optional] asyncContext

Puntatore a una struttura di dati WS_ASYNC_CONTEXT con informazioni su come richiamare la funzione in modo asincrono. Un valore NULL indica una richiesta per l'operazione sincrona.

[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_S_ASYNC
 L'operazione asincrona è ancora in sospeso.
WS_E_OPERATION_ABORTED
 L'operazione è stata interrotta.
WS_E_INVALID_OPERATION
 L'operazione non è consentita a causa dello stato corrente dell'oggetto .
WS_E_ENDPOINT_DISCONNECTED
 La connessione con l'endpoint remoto è stata terminata.
WS_E_INVALID_FORMAT
 I dati di input non erano nel formato previsto o non hanno il valore previsto.
WS_E_OPERATION_TIMED_OUT
 L'operazione non è stata completata entro il tempo assegnato.
WS_E_QUOTA_EXCEEDED
 È stata superata una quota.
WS_E_SECURITY_VERIFICATION_FAILURE
 La verifica di sicurezza non è riuscita per i dati ricevuti.
WS_E_SECURITY_SYSTEM_FAILURE
 Un'operazione di sicurezza non è riuscita nel framework di Servizi Web Windows.
WS_E_SECURITY_TOKEN_EXPIRED
 Un token di sicurezza è stato rifiutato dal server perché è scaduto.
E_OUTOFMEMORY
 Memoria insufficiente.
E_INVALIDARG
 Uno o più argomenti non sono validi.
Altri errori
Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Il messaggio di risposta includerà le informazioni di correlazione appropriate per il WS_ADDRESSING_VERSION. Per altre informazioni sulla correlazione dei messaggi di risposta di richiesta, vedere Panoramica del livello del canale .

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