WS_ENDPOINT_ADDRESS struttura (webservices.h)

Rappresenta l'indirizzo di rete di un endpoint.

Sintassi

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

Members

url

Parte URL dell'indirizzo.

L'URL è sempre in formato escape.

Se questa stringa è zero-length, si presuppone che l'URL sia l'indirizzo anonimo. La stringa di indirizzo anonima viene mappata automaticamente a/dalla stringa di lunghezza zero quando l'indirizzo dell'endpoint viene serializzato o deserializzato usando WS_ENDPOINT_ADDRESS_TYPE.

Il valore di questo campo corrisponde all'elemento Address delle specifiche WS-Addressing.

headers

Handle WS_XML_BUFFER a un set di elementi di intestazione che rappresentano i parametri di riferimento per l'indirizzo dell'endpoint.

Le intestazioni sono necessarie per interagire correttamente con l'endpoint. Vengono usati per qualificare ulteriormente l'indirizzo (URL).

Le intestazioni devono essere considerate come valori opachi all'utente dell'indirizzo dell'endpoint.

Per informazioni su come aggiungere le intestazioni a un messaggio inviato, vedere WsAddressMessage .

Questo campo può essere NULL se non sono presenti intestazioni.

Questo valore di questo campo corrisponde al contenuto dell'elemento ReferenceParameters delle specifiche WS-Addressing.

extensions

Handle WS_XML_BUFFER a un set di elementi di estensione. Gli elementi di estensione vengono usati per includere informazioni aggiuntive all'interno di un indirizzo endpoint. Questo campo può essere NULL se non sono presenti elementi di estensione.

Questo valore di questo campo corrisponde agli altri elementi definiti da WS-Addressing e tutti gli elementi di estensione. Gli elementi devono essere visualizzati nell'ordine corretto in base alla specifica, seguita dagli elementi di estensione. Questo campo non deve contenere elementi per Address o ReferenceParameters o Identity, poiché questi valori sono rappresentati direttamente da altri campi di questa struttura.

Se l'elemento ReferenceProperties è presente (come definito da WS_ADDRESSING_VERSION_0_9), deve essere il primo elemento all'interno del WS_XML_BUFFER.

identity

Identità di sicurezza dell'endpoint rappresentata dall'indirizzo dell'endpoint.

Questo campo corrisponde all'elemento Identity, ovvero un'estensione delle specifiche di base WS-Addressing.

Commenti

È necessario solo il campo URL (altri campi possono essere NULL).

Requisiti

Client minimo supportato	Windows 7 [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop | App UWP]
Intestazione	webservices.h