WsAddressMessage-Funktion (webservices.h)

Artikel
08/27/2023

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.

Hinweis Das Übergeben von NULL an diesen Parameter gibt an, dass der Nachricht keine Header hinzugefügt werden. Dies bietet eine Möglichkeit, die WS_MESSAGE_PROPERTY_ID auf WS_MESSAGE_PROPERTY_IS_ADDRESSED festzulegen, ohne den Satz von Headern in der Nachricht zu ändern.

[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.

Rückgabecode	Beschreibung
WS_E_INVALID_OPERATION	Die Nachricht wurde bereits adressiert. (Die WS_MESSAGE_PROPERTY_IS_ADDRESSED-Eigenschaft gibt an, ob eine Nachricht bereits adressiert wurde.)
E_INVALIDARG	Mindestens ein Argument ist ungültig.
WS_E_INVALID_FORMAT	Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
Andere Fehler	Diese Funktion kann andere Fehler zurückgeben, die oben nicht aufgeführt sind.

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


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