estructura de WS_ENDPOINT_ADDRESS (webservices.h)

Representa la dirección de red de un punto de conexión.

Sintaxis

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

Miembros

url

Parte de la dirección URL.

La dirección URL siempre está en formato de escape.

Si esta cadena es de longitud cero, se supone que la dirección URL es la dirección anónima. La cadena de dirección anónima se asigna automáticamente a o desde la cadena de longitud cero cuando la dirección del punto de conexión se serializa o deserializa mediante WS_ENDPOINT_ADDRESS_TYPE.

El valor de este campo corresponde al elemento Address de las especificaciones de WS-Addressing.

headers

Un WS_XML_BUFFER identificador de un conjunto de elementos de encabezado que representan los parámetros de referencia para la dirección del punto de conexión.

Los encabezados son necesarios para interactuar correctamente con el punto de conexión. Se usan para calificar aún más la dirección (URL).

Los encabezados deben tratarse como valores opacos para el usuario de la dirección del punto de conexión.

Consulte WsAddressMessage para obtener información sobre cómo agregar los encabezados a un mensaje que se envía.

Este campo puede ser NULL si no hay encabezados.

Este valor de este campo corresponde al contenido del elemento ReferenceParameters de las especificaciones de WS-Addressing.

extensions

Un WS_XML_BUFFER identificador de un conjunto de elementos de extensión. Los elementos de extensión se usan para incluir información adicional dentro de una dirección de punto de conexión. Este campo puede ser NULL si no hay elementos de extensión.

Este valor de este campo corresponde a los demás elementos definidos por WS-Addressing y cualquier elemento de extensión. Los elementos deben aparecer en el orden correcto según la especificación, seguido de los elementos de extensión. Este campo no debe contener elementos para Address o ReferenceParameters, o Identity, ya que estos valores se representan directamente mediante otros campos de esta estructura.

Si el elemento ReferenceProperties está presente (definido por WS_ADDRESSING_VERSION_0_9), debe ser el primer elemento dentro del WS_XML_BUFFER.

identity

Identidad de seguridad del punto de conexión representado por esta dirección de punto de conexión.

Este campo corresponde al elemento Identity, que es una extensión de las especificaciones base WS-Addressing.

Comentarios

Solo se requiere el campo URL (otros campos pueden ser NULL).

Requisitos