Condividi tramite


Funzione WsResetMessage (webservices.h)

Imposta nuovamente lo stato del messaggio su WS_MESSAGE_STATE_EMPTY. In questo stato l'oggetto Message può essere riutilizzato.

Sintassi

HRESULT WsResetMessage(
  [in]           WS_MESSAGE *message,
  [in, optional] WS_ERROR   *error
);

Parametri

[in] message

Puntatore all'oggetto Message da reimpostare.

[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_INVALIDARG
Uno o più argomenti non sono validi.

Commenti

Quando un messaggio viene reimpostato, viene reimpostato l'heap sottostante.

Il riutilizzo di un oggetto messaggio per ricevere o inviare più messaggi è in genere più efficiente rispetto alla creazione e alla liberazione dell'oggetto messaggio per ogni 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