Eindpuntadres

Een eindpuntadres vertegenwoordigt het adres van een service in het netwerk. Wanneer u een kanaalopent, moet u het eindpuntadres opgeven van de service waarmee u wilt communiceren en het kanaal waarmee u wilt communiceren, door de functie WsOpenChan nel aan te roepen.

Een eindpuntadres bestaat uit:

• een URL-
• een set headers (optioneel)
• een set extensies (optioneel)
• een optionele identiteit die de beveiligingsidentiteit van de service vertegenwoordigt.

Wanneer een bericht wordt geadresseerd, wordt de URL de kop 'Aan' van het bericht. Eventuele headers die deel uitmaken van het eindpuntadres, worden ook toegevoegd aan het bericht.

Kanalen adresseren automatisch alle berichten die worden verzonden met behulp van de WS_ENDPOINT_ADDRESS structuur die is doorgegeven aan de WsOpenChannel-. U kunt ook de functie WsAddressMessage gebruiken om dit standaardgedrag te overschrijven.

Wanneer WS_ENDPOINT_ADDRESS als parameter wordt doorgegeven, maken de WsOpenChannel- en functies van WsOpenServiceProxy een kopie van de parameter WS_ENDPOINT_ADDRESS in het geheugen en de grootte ervan wordt beperkt door 65536 bytes. WsAddressMessage- heeft deze beperking niet omdat hiervoor geen kopie van de parameter WS_ENDPOINT_ADDRESS hoeft te worden gemaakt.

De extensies die zijn opgegeven in het -extensies veld van WS_ENDPOINT_ADDRESS worden niet gebruikt voor het adresseren van het bericht, maar zijn in plaats daarvan een uitbreidbaarheidsmechanisme dat kan worden gebruikt om aanvullende informatie (bijvoorbeeld metagegevens) over de service te verstrekken. Algemene extensies kunnen worden gelezen met de WsReadEndpointAddressExtension functie.

Het optionele identiteitsveld van het eindpuntadres kan bijvoorbeeld de DNS-naam bevatten van de computer waarop de service wordt uitgevoerd, of de UPN van het Windows-account waaronder de service wordt uitgevoerd. Het identiteitsveld wordt niet gebruikt bij het adresseren van het bericht, maar kan worden gebruikt voor het verkrijgen van een beveiligingstoken voor de service (bijvoorbeeld voor het verkrijgen van een Kerberos-ticket naar de doel-UPN) en voor het verifiëren van de identiteit van de serviceantwoorden (bijvoorbeeld een DNS-identiteit die wordt gebruikt voor naamcontroles op het servicecertificaat dat tijdens SSL wordt geretourneerd).

Eindpuntadressen kunnen worden gelezen en geschreven met behulp van serialisatie met de WS_ENDPOINT_ADDRESS_TYPE opsommingswaarde uit WS_TYPE. Als u een eindpuntadres wilt serialiseren, moet u weten welke versie van de specificatie wordt gebruikt voor de adresseringsheaders, zoals opgegeven in de opsomming WS_ADDRESSING_VERSION.