WsWriteEnvelopeEnd-Funktion (webservices.h)

  • Artikel

Schreibt die schließende Elemente einer Nachricht. Diese Funktion schreibt das Ende der Nachricht, einschließlich des Elements, das das Tag body und das Envelope-Tag schließt. Verwenden Sie diese Funktion beim Schreiben von Nachrichten an andere Ziele als Kanäle. Verwenden Sie mit Kanälen WsWriteMessageEnd

Syntax

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

Parameter

[in] message

Ein Zeiger auf das zu schreibende Message-Objekt . Der Zeiger muss auf ein gültiges WS_MESSAGE-Objekt verweisen.

[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
WS_E_INVALID_FORMAT
 Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.
E_OUTOFMEMORY
 Der Arbeitsspeicher ist nicht mehr vorhanden.
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
Andere Fehler
Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Um diese Funktion verwenden zu können, muss der Nachrichtenstatus auf WS_MESSAGE_STATE_WRITING festgelegt werden. Wenn sie im richtigen Zustand aufgerufen wird, wechselt die Nachricht zu WS_MESSAGE_STATE_DONE unabhängig davon, ob die Funktion fehlschlägt oder nicht.

Anforderungen

   
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