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 |
---|---|
|
Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen. |
|
Mindestens ein Argument ist ungültig. |
|
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 |