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 |
---|---|
|
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 |