structure WS_ENDPOINT_ADDRESS (webservices.h)

  • Article

Représente l’adresse réseau d’un point de terminaison.

Syntaxe

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

Membres

url

Partie URL de l’adresse.

L’URL est toujours sous forme d’échappement.

Si cette chaîne est de longueur nulle, l’URL est supposée être l’adresse anonyme. La chaîne d’adresse anonyme est automatiquement mappée à/à partir de la chaîne de longueur nulle lorsque l’adresse du point de terminaison est sérialisée ou désérialisée à l’aide de WS_ENDPOINT_ADDRESS_TYPE.

La valeur de ce champ correspond à l’élément Address des spécifications WS-Addressing.

headers

Un WS_XML_BUFFER gérer un ensemble d’éléments d’en-tête qui représentent les paramètres de référence pour l’adresse du point de terminaison.

Les en-têtes sont nécessaires pour interagir correctement avec le point de terminaison. Ils sont utilisés pour qualifier davantage l’adresse (URL).

Les en-têtes doivent être traités comme des valeurs opaques pour l’utilisateur de l’adresse de point de terminaison.

Pour plus d’informations sur l’ajout des en-têtes à un message envoyé, consultez WsAddressMessage .

Ce champ peut avoir la valeur NULL s’il n’y a pas d’en-têtes.

Cette valeur de ce champ correspond au contenu de l’élément ReferenceParameters des spécifications WS-Addressing.

extensions

Un handle WS_XML_BUFFER à un ensemble d’éléments d’extension. Les éléments d’extension sont utilisés pour inclure des informations supplémentaires dans une adresse de point de terminaison. Ce champ peut avoir la valeur NULL s’il n’existe aucun élément d’extension.

Cette valeur de ce champ correspond aux autres éléments définis par WS-Addressing et à tous les éléments d’extension. Les éléments doivent apparaître dans l’ordre correct selon la spécification, suivis des éléments d’extension. Ce champ ne doit pas contenir d’éléments pour Address, ReferenceParameters ou Identity, car ces valeurs sont représentées directement par d’autres champs de cette structure.

Si l’élément ReferenceProperties est présent (tel que défini par WS_ADDRESSING_VERSION_0_9), il doit s’agir du premier élément dans le WS_XML_BUFFER.

identity

Identité de sécurité du point de terminaison représenté par cette adresse de point de terminaison.

Ce champ correspond à l’élément Identity, qui est une extension des spécifications de base WS-Addressing.

Remarques

Seul le champ URL est requis (d’autres champs peuvent avoir la valeur NULL).

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
En-tête webservices.h