Freigeben über


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.

Rückgabecode Beschreibung
E_INVALIDARG
Mindestens ein Argument ist ungültig.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll