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