WsInitializeMessage-Funktion (webservices.h)

Artikel
08/27/2023

Diese Funktion initialisiert die Header für die Nachricht, um die Verarbeitung vorzubereiten. Nachdem eine Nachricht initialisiert wurde, kann eine Anwendung zusätzliche Header hinzufügen. Bei Erfolg befindet sich die Nachricht in WS_MESSAGE_STATE_INITIALIZED Zustand. Wenn die Funktion fehlschlägt, treten keine Zustandsübergänge auf.

Syntax

HRESULT WsInitializeMessage(
  [in]           WS_MESSAGE                *message,
  [in]           WS_MESSAGE_INITIALIZATION initialization,
  [in, optional] WS_MESSAGE                *sourceMessage,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] message

Ein Zeiger auf das zu initialisierende Message-Objekt. Die Message muss ein gültiges WS_MESSAGE-Objekt instance sein, das von WsCreateMessage oder WsCreateMessageForChannel zurückgegeben wird, und darf nicht NULL sein.

[in] initialization

Definiert die Nachrichteninitialisierung.

Hinweis Wenn der Initialisierungswert auf WS_REPLY_MESSAGE oder WS_FAULT_MESSAGE wird die Nachricht automatisch adressiert.

[in, optional] sourceMessage

Ein Zeiger auf ein Nachrichtenobjekt, das zum Initialisieren des Nachrichtenparameters verwendet wird. Dieser Wert sollte NULL sein, es sei denn, der Initialisierungsparameter weist den Wert WS_DUPLICATE_MESSAGE, WS_REPLY_MESSAGE oder WS_FAULT_MESSAGE auf.

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

Der ursprüngliche Absender einer Nachricht sollte der Nachricht mithilfe von WsSetHeader einen Aktionsheader hinzufügen.

Diese API muss aufgerufen werden, bevor WsWriteEnvelopeStart oder WsWriteMessageStart für die Nachricht aufgerufen wird.

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