WsCreateMessage-Funktion (webservices.h)

Artikel
03/13/2024

Erstellt ein Nachrichtenobjekt mit den angegebenen Eigenschaften.

Syntax

HRESULT WsCreateMessage(
  [in]           WS_ENVELOPE_VERSION       envelopeVersion,
  [in]           WS_ADDRESSING_VERSION     addressingVersion,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] envelopeVersion

Ein WS_ENVELOPE_VERSION Enumerationswert, der die Version des Umschlags für die Nachricht angibt.

[in] addressingVersion

Eine WS_ADDRESSING_VERSION , die die Version der Adressierung für die Nachricht angibt.

properties

Ein Array optionaler Eigenschaften für die Nachricht. Siehe WS_MESSAGE_PROPERTY.

Der Wert dieses Parameters kann NULL sein. In diesem Fall muss der propertyCount-Parameter 0 (null) sein.

[in] propertyCount

Die Anzahl der Eigenschaften im Eigenschaftenarray .

message

Bei Erfolg ein Zeiger, der die Adresse einer WS_MESSAGE Struktur empfängt, die die neue Nachricht darstellt.

Wenn Sie diese Struktur nicht mehr benötigen, müssen Sie sie durch Aufrufen von WsFreeMessage freigeben.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
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

Ein Nachrichtenobjekt ist das Übermittlungsfahrzeug für Windows-Webdienste. Ein einzelnes Nachrichtenobjekt kann zum Senden oder Empfangen sequenzieller Nachrichten verwendet werden. Die Wiederverwendung eines Nachrichtenobjekts auf diese Weise kann die Speicherbelegung reduzieren. Wenn Sie die Nachricht nicht mehr benötigen, müssen Sie den Arbeitsspeicher freigeben, indem Sie WsFreeMessage aufrufen. (Weitere Informationen zur Wiederverwendung von Nachrichtenobjekten finden Sie unter WsResetMessage .)

Wenn Sie eine Nachricht zur Verwendung mit einem bestimmten Kanal erstellen, verwenden Sie die WsCreateMessageForChannel-Funktion , die die richtige Nachrichtenversion für den Kanal sicherstellt.

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