Freigeben über


WsCreateMessage-Funktion (webservices.h)

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