estrutura WS_ENDPOINT_ADDRESS (webservices.h)

Representa o endereço de rede de um ponto de extremidade.

Sintaxe

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

Membros

url

A parte da URL do endereço.

A URL está sempre em forma de escape.

Se essa cadeia de caracteres for de comprimento zero, a URL será considerada o endereço anônimo. A cadeia de caracteres de endereço anônimo é mapeada automaticamente de/para a cadeia de caracteres de comprimento zero quando o endereço do ponto de extremidade é serializado ou desserializado usando WS_ENDPOINT_ADDRESS_TYPE.

O valor desse campo corresponde ao elemento Address das especificações de WS-Addressing.

headers

Um identificador WS_XML_BUFFER para um conjunto de elementos de cabeçalho que representam os parâmetros de referência para o endereço do ponto de extremidade.

Os cabeçalhos são necessários para interagir corretamente com o ponto de extremidade. Eles são usados para qualificar ainda mais o endereço (URL).

Os cabeçalhos devem ser tratados como valores opacos para o usuário do endereço do ponto de extremidade.

Consulte WsAddressMessage para obter informações sobre como adicionar os cabeçalhos a uma mensagem que está sendo enviada.

Esse campo poderá ser NULL se não houver cabeçalhos.

Esse valor desse campo corresponde ao conteúdo do elemento ReferenceParameters das especificações de WS-Addressing.

extensions

Um identificador WS_XML_BUFFER para um conjunto de elementos de extensão. Os elementos de extensão são usados para incluir informações adicionais em um endereço de ponto de extremidade. Esse campo poderá ser NULL se não houver elementos de extensão.

Esse valor desse campo corresponde aos outros elementos definidos por WS-Addressing e quaisquer elementos de extensão. Os elementos devem aparecer na ordem correta de acordo com a especificação, seguidos por elementos de extensão. Esse campo não deve conter elementos para Address ou ReferenceParameters ou Identity, pois esses valores são representados diretamente por outros campos dessa estrutura.

Se o elemento ReferenceProperties estiver presente (conforme definido por WS_ADDRESSING_VERSION_0_9), ele deverá ser o primeiro elemento dentro do WS_XML_BUFFER.

identity

A identidade de segurança do ponto de extremidade representado por esse endereço de ponto de extremidade.

Esse campo corresponde ao elemento Identity, que é uma extensão das especificações de WS-Addressing base.

Comentários

Somente o campo URL é necessário (outros campos podem ser NULL).

Requisitos