Slutpunktsadress
En slutpunktsadress representerar adressen till en tjänst i nätverket. När du öppnar en kanal, genom att anropa funktionen WsOpenChannel, måste du ange slutpunktsadressen för den tjänst som du ska kommunicera med samt ange den kanal som du vill öppna.
En slutpunktsadress består av:
- en URL
- en uppsättning rubriker (valfritt)
- en uppsättning tillägg (valfritt)
- en valfri identitet som representerar tjänstens säkerhetsidentitet.
När ett meddelande adresseras blir URL:en "Till"-rubriken för meddelandet. Alla rubriker som ingår i slutpunktsadressen läggs också till i meddelandet.
Kanaler hanterar automatiskt alla meddelanden som skickas med hjälp av den WS_ENDPOINT_ADDRESS struktur som skickades till WsOpenChannel-. Du kan också använda funktionen WsAddressMessage för att åsidosätta det här standardbeteendet.
När WS_ENDPOINT_ADDRESS skickas som en parameter skapar funktionerna WsOpenChannel och WsOpenServiceProxy en kopia av parametern WS_ENDPOINT_ADDRESS i minnet och dess storlek begränsas med 65536 byte. WsAddressMessage har inte den här begränsningen eftersom den inte kräver att en kopia av parametern WS_ENDPOINT_ADDRESS skapas.
Tilläggen som anges i tillägg fält i WS_ENDPOINT_ADDRESS används inte för att hantera meddelandet, utan är i stället en utökningsmekanism som kan användas för att ge ytterligare information (till exempel metadata) om tjänsten. Vanliga tillägg kan läsas med funktionen WsReadEndpointAddressExtension.
Det valfria identitetsfältet för slutpunktsadressen kan till exempel innehålla DNS-namnet på den dator där tjänsten körs eller UPN för Det Windows-konto som tjänsten körs under. Identitetsfältet används inte för att adressera meddelandet, men kan användas för att hämta en säkerhetstoken för tjänsten (till exempel för att hämta en Kerberos-biljett till mål-UPN) och för att verifiera identiteten för tjänstsvaren (till exempel en DNS-identitet som används för namnkontroller på tjänstcertifikatet som returnerades under SSL).
Slutpunktsadresser kan läsas och skrivas med serialisering med WS_ENDPOINT_ADDRESS_TYPE uppräkningsvärdet från WS_TYPE. Obs! För att kunna serialisera en slutpunktsadress måste du känna till den version av specifikationen som används för adresshuvudena enligt WS_ADDRESSING_VERSION uppräkning.