Funzione WsCreateMessage (webservices.h)

  • Articolo

Crea un oggetto messaggio con le proprietà specificate.

Sintassi

HRESULT WsCreateMessage(
  [in]           WS_ENVELOPE_VERSION       envelopeVersion,
  [in]           WS_ADDRESSING_VERSION     addressingVersion,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

Parametri

[in] envelopeVersion

Valore di enumerazione WS_ENVELOPE_VERSION che specifica la versione della busta per il messaggio.

[in] addressingVersion

Oggetto WS_ADDRESSING_VERSION che specifica la versione dell'indirizzamento per il messaggio.

properties

Matrice di proprietà facoltative per il messaggio. Vedere WS_MESSAGE_PROPERTY.

Il valore di questo parametro può essere NULL, nel qual caso il parametro propertyCount deve essere 0 (zero).

[in] propertyCount

Numero di proprietà nella matrice delle proprietà .

message

In caso di esito positivo, un puntatore che riceve l'indirizzo di una struttura WS_MESSAGE che rappresenta il nuovo messaggio.

Quando questa struttura non è più necessaria, è necessario liberarla chiamando WsFreeMessage.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.

Codice restituito Descrizione
E_OUTOFMEMORY
 Memoria insufficiente per completare l'operazione.
E_INVALIDARG
 Uno o più argomenti non sono validi.
Altri errori
Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Un oggetto messaggio è il veicolo di recapito per Servizi Web Windows. Un singolo oggetto messaggio può essere usato per inviare o ricevere messaggi sequenziali. Il riutilizzo di un oggetto messaggio in questo modo può ridurre le allocazioni di memoria. Quando il messaggio non è più necessario, è necessario liberare la memoria chiamando WsFreeMessage. Per altre informazioni sul riutilizzo di oggetti messaggio, vedere WsResetMessage .

Se si sta creando un messaggio da usare con un canale specifico, usare la funzione WsCreateMessageForChannel , che garantisce la versione corretta del messaggio per il 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