WsResetMessage-Funktion (webservices.h)

Artikel
03/06/2024

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

Freigeben über