WS_ENDPOINT_ADDRESS-Struktur (webservices.h)

Stellt die Netzwerkadresse eines Endpunkts dar.

Syntax

typedef struct _WS_ENDPOINT_ADDRESS {
  WS_STRING            url;
  WS_XML_BUFFER        *headers;
  WS_XML_BUFFER        *extensions;
  WS_ENDPOINT_IDENTITY *identity;
} WS_ENDPOINT_ADDRESS;

Member

url

Der URL-Teil der Adresse.

Die URL befindet sich immer in Escapeform.

Wenn diese Zeichenfolge die Länge null hat, wird angenommen, dass es sich bei der URL um die anonyme Adresse handelt. Die anonyme Adresszeichenfolge wird automatisch der Zeichenfolge der Länge Null zugeordnet, wenn die Endpunktadresse mithilfe von WS_ENDPOINT_ADDRESS_TYPE serialisiert oder deserialisiert wird.

Der Wert dieses Felds entspricht dem Address-Element der WS-Addressing Spezifikationen.

headers

Ein WS_XML_BUFFER Handle für einen Satz von Headerelementen, die die Verweisparameter für die Endpunktadresse darstellen.

Die Header müssen ordnungsgemäß mit dem Endpunkt interagieren. Sie werden verwendet, um die Adresse (URL) weiter zu qualifizieren.

Die Header sollten als undurchsichtige Werte für den Benutzer der Endpunktadresse behandelt werden.

Informationen zum Hinzufügen der Header zu einer gesendeten Nachricht finden Sie unter WsAddressMessage .

Dieses Feld kann NULL sein, wenn keine Header vorhanden sind.

Dieser Wert dieses Felds entspricht dem Inhalt des ReferenceParameters-Elements der WS-Addressing Spezifikationen.

extensions

Ein WS_XML_BUFFER Handle für eine Reihe von Erweiterungselementen. Erweiterungselemente werden verwendet, um zusätzliche Informationen in eine Endpunktadresse einzuschließen. Dieses Feld kann NULL sein, wenn keine Erweiterungselemente vorhanden sind.

Dieser Wert dieses Felds entspricht den anderen Elementen, die durch WS-Addressing und alle Erweiterungselemente definiert werden. Die Elemente müssen gemäß der Spezifikation in der richtigen Reihenfolge angezeigt werden, gefolgt von Erweiterungselementen. Dieses Feld sollte keine Elemente für Address, ReferenceParameters oder Identity enthalten, da diese Werte direkt von anderen Feldern dieser Struktur dargestellt werden.

Wenn das ReferenceProperties-Element vorhanden ist (wie durch WS_ADDRESSING_VERSION_0_9 definiert), muss es das erste Element innerhalb des WS_XML_BUFFER sein.

identity

Die Sicherheitsidentität des Endpunkts, der durch diese Endpunktadresse dargestellt wird.

Dieses Feld entspricht dem Identity-Element, das eine Erweiterung der Basisspezifikationen WS-Addressing ist.

Hinweise

Es ist nur das URL-Feld erforderlich (andere Felder können NULL sein).

Anforderungen