WsAddressMessage-Funktion (webservices.h)

Adressieren einer Nachricht an eine angegebene Endpunktadresse.

Syntax

HRESULT WsAddressMessage(
  [in]           WS_MESSAGE                *message,
  [in, optional] const WS_ENDPOINT_ADDRESS *address,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] message

Zeiger auf eine WS_MESSAGE-Struktur , die die zu adressierende Nachricht darstellt.

[in, optional] address

Zeiger auf eine WS_ENDPOINT_ADDRESS-Struktur , die den Endpunkt enthält, an den die Nachricht adressieren soll.

[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, gibt sie NO_ERROR zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Wenn Sie eine Nachricht nicht adressieren, indem Sie diese Funktion aufrufen, adressiert der Kanal die Nachricht automatisch mit der Endpunktadresse , die an WsOpenChannel übergeben wird.

Diese Funktion markiert die Nachricht als adressiert, indem die WS_MESSAGE_PROPERTY_IS_ADDRESSED-Eigenschaft auf TRUE festgelegt wird.

Diese Funktion schlägt fehl, wenn die Nachricht bereits adressiert wurde und WS_E_INVALID_OPERATION zurückgibt.

Wenn ein nicht NULL-WS_ENDPOINT_ADDRESS an die Funktion übergeben wird, führt die Funktion die folgenden zusätzlichen Schritte aus:

• Der Headertyp ist auf WS_TO_HEADER festgelegt (siehe WS_HEADER_TYPE-Enumeration ), und die Adresse wird auf den Wert des URL-Felds von WS_ENDPOINT_ADDRESS festgelegt. Wenn die URL-Länge 0 ist, wird die WS_ADDRESSING_VERSION spezifische Darstellung für eine anonyme URL für die Nachricht festgelegt.
• Jeder Header im WS_XML_BUFFER , der im Feld headers des WS_ENDPOINT_ADDRESS angegeben ist, wird der Nachricht hinzugefügt. Es werden keine Header hinzugefügt, wenn der Puffer NULL ist.

Anforderungen