Funzione WsSendMessage (webservices.h)

  • Articolo

Inviare un messaggio su un canale usando la serializzazione per scrivere l'elemento del corpo.

Sintassi

HRESULT WsSendMessage(
  [in]           WS_CHANNEL                   *channel,
  [in]           WS_MESSAGE                   *message,
  [in]           const WS_MESSAGE_DESCRIPTION *messageDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *bodyValue,
  [in]           ULONG                        bodyValueSize,
  [in, optional] const WS_ASYNC_CONTEXT       *asyncContext,
  [in, optional] WS_ERROR                     *error
);

Parametri

[in] channel

Canale in cui inviare il messaggio.

[in] message

Oggetto messaggio da utilizzare per l'invio.

L'oggetto messaggio deve trovarsi in WS_MESSAGE_STATE_EMPTY o WS_MESSAGE_STATE_INITIALIZED.

[in] messageDescription

Il campo dell'azione del WS_MESSAGE_DESCRIPTION viene usato come intestazione dell'azione per il messaggio. 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. Questo campo può essere NULL se non si desidera alcun elemento body. Per informazioni su come viene usato bodyElementDescription per serializzare il valore, vedere WsWriteBody .

[in] writeOption

Indica se l'elemento body è obbligatorio e la modalità di allocazione del valore. Viene usato solo quando si desidera un elemento del corpo. Per altre informazioni, vedere WS_WRITE_OPTION e WsWriteBody.

bodyValue

Valore da serializzare nel corpo del messaggio.

[in] bodyValueSize

Dimensione del valore serializzato, in byte.

[in, optional] asyncContext

Informazioni su come richiamare la funzione in modo asincrono o NULL se si richiama in modo sincrono.

[in, optional] error

Specifica dove archiviare 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_NOT_FOUND
 L'endpoint remoto non esiste o non è stato possibile individuarsi.
WS_E_ENDPOINT_ACCESS_DENIED
 L'accesso è stato negato dall'endpoint remoto.
WS_E_ENDPOINT_DISCONNECTED
 La connessione con l'endpoint remoto è stata terminata.
WS_E_ENDPOINT_FAILURE
 L'endpoint remoto non è riuscito a elaborare la richiesta.
WS_E_ENDPOINT_NOT_AVAILABLE
 L'endpoint remoto non è attualmente in servizio in questa posizione.
WS_E_ENDPOINT_TOO_BUSY
 L'endpoint remoto non è in grado di elaborare la richiesta a causa dell'overload.
WS_E_ENDPOINT_UNREACHABLE
 L'endpoint remoto non è raggiungibile.
WS_E_INVALID_ENDPOINT_URL
 L'URL dell'indirizzo dell'endpoint non è valido.
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_PROXY_ACCESS_DENIED
 Accesso negato dal server proxy HTTP.
WS_E_PROXY_FAILURE
 Il server proxy HTTP non è riuscito a elaborare la richiesta.
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.
WS_E_PROXY_REQUIRES_BASIC_AUTH
 Il server proxy HTTP richiede lo schema di autenticazione HTTP "basic".
WS_E_PROXY_REQUIRES_DIGEST_AUTH
 Il server proxy HTTP richiede lo schema di autenticazione HTTP "digest".
WS_E_PROXY_REQUIRES_NEGOTIATE_AUTH
 Il server proxy HTTP richiede lo schema di autenticazione HTTP 'negotiate'.
WS_E_PROXY_REQUIRES_NTLM_AUTH
 Il server proxy HTTP richiede lo schema di autenticazione HTTP 'NTLM'.
WS_E_SERVER_REQUIRES_BASIC_AUTH
 L'endpoint remoto richiede lo schema di autenticazione HTTP 'basic'.
WS_E_SERVER_REQUIRES_DIGEST_AUTH
 L'endpoint remoto richiede lo schema di autenticazione HTTP "digest".
WS_E_SERVER_REQUIRES_NEGOTIATE_AUTH
 L'endpoint remoto richiede lo schema di autenticazione HTTP 'negotiate'.
WS_E_SERVER_REQUIRES_NTLM_AUTH
 L'endpoint remoto richiede lo schema di autenticazione HTTP 'NTLM'.
CERT_E_EXPIRED
 Un certificato obbligatorio non rientra nel periodo di validità durante la verifica rispetto all'orologio di sistema corrente o al timestamp nel file firmato.
CERT_E_CN_NO_MATCH
 Il nome CN dei certificati non corrisponde al valore passato.
CERT_E_UNTRUSTEDROOT
 Catena di certificati elaborata, ma terminata in un certificato radice che non è considerato attendibile dal provider di attendibilità.
CERT_E_WRONG_USAGE
 Il certificato non è valido per l'utilizzo richiesto.
CRYPT_E_REVOCATION_OFFLINE
 La funzione di revoca non è in grado di completare il controllo di revoca perché il server di revoca è offline.
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

Per includere intestazioni personalizzate con il messaggio, inizializzare il messaggio WsInitializeMessage con WS_BLANK_MESSAGE e quindi aggiungere le intestazioni usando WsAddCustomHeader prima di chiamare questa funzione.

Requisiti

   
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