WsResetMessage-Funktion (webservices.h)

Legt den Nachrichtenstatus wieder auf WS_MESSAGE_STATE_EMPTY fest. In diesem Zustand kann das Message-Objekt wiederverwendet werden.

Syntax

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

Parameter

[in] message

Ein Zeiger auf das zurückzusetzende Message-Objekt.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Hinweise

Wenn eine Nachricht zurückgesetzt wird, wird der zugrunde liegende Heap zurückgesetzt.

Die Wiederverwendung eines Nachrichtenobjekts zum Empfangen oder Senden mehrerer Nachrichten ist im Allgemeinen effizienter als das Erstellen und Freigeben des Nachrichtenobjekts für jede Nachricht.

Anforderungen