WsCreateMessageForChannel-Funktion (webservices.h)

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.

Hinweise

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

Anforderungen