WsCreateMessageForChannel-Funktion (webservices.h)

Artikel
03/06/2024

Erstellt eine Nachricht zur Verwendung mit einem angegebenen Kanal.

Syntax

HRESULT WsCreateMessageForChannel(
  [in]           WS_CHANNEL                *channel,
                 const WS_MESSAGE_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_MESSAGE                **message,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] channel

Zeiger auf eine WS_CHANNEL-Struktur , die den Kanal für die Nachricht darstellt.

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 der 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

Im Gegensatz zur allgemeineren WsCreateMessage-Funktion stellt WsCreateMessageForChannel sicher, dass die verwendete Nachrichtenversion für den Kanal geeignet ist.

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