Végpont címe
A végpontcím a hálózaton lévő szolgáltatás címét jelöli. A csatornamegnyitásakor a WsOpenChannel függvény meghívásával meg kell adnia annak a szolgáltatásnak a végpontcímét, amellyel kommunikálni szeretne, valamint meg kell adnia a megnyitni kívánt csatornát.
A végpontcímek a következőkből állnak:
- URL-
- fejlécek készlete (nem kötelező)
- bővítmények készlete (nem kötelező)
- nem kötelező identitás a szolgáltatás biztonsági identitását.
Amikor egy üzenetet megcímeznek, az URL-cím lesz az üzenet "Címzett" fejléce. A végpontcím részét képező fejlécek is hozzá lesznek adva az üzenethez.
A csatornák automatikusan kezelik az elküldött üzeneteket a WsOpenChannelátadott WS_ENDPOINT_ADDRESS struktúrával. A WsAddressMessage függvénnyel felülbírálhatja ezt az alapértelmezett viselkedést.
Ha WS_ENDPOINT_ADDRESS paraméterként van átadva, a WsOpenChannel és WsOpenServiceProxy függvények létrehozzák a WS_ENDPOINT_ADDRESS paraméter másolatát a memóriában, mérete pedig 65536 bájt. WsAddressMessage nem rendelkezik ezzel a korlátozással, mert nincs szükség a WS_ENDPOINT_ADDRESS paraméter másolatának létrehozására.
A bővítményekWS_ENDPOINT_ADDRESS mezőjében megadott bővítmények nem az üzenet kezelésére szolgálnak, hanem egy bővíthetőségi mechanizmus, amellyel további információkat (például metaadatokat) adhat meg a szolgáltatásról. A gyakori bővítmények a WsReadEndpointAddressExtension függvénnyel olvashatók.
A végpontcím választható identitásmezője lehet például annak a gépnek a DNS-neve, amelyen a szolgáltatás fut, vagy annak a Windows-fióknak az UPN-je, amelyen a szolgáltatás fut. Az identitásmező nem használatos az üzenet kezeléséhez, de használható a szolgáltatás biztonsági jogkivonatának beszerzéséhez (például Kerberos-jegy lekéréséhez a cél UPN-hez), valamint a szolgáltatás válaszainak identitásának ellenőrzéséhez (például az SSL során visszaadott szolgáltatástanúsítvány névellenőrzéséhez használt DNS-identitás).
A végpontcímek olvashatók és írhatók szerializálásiWS_ENDPOINT_ADDRESS_TYPEWS_TYPEenumerálási értékével. Megjegyzés: a végpontcímek szerializálásához ismernie kell a címzési fejlécekhez használt specifikáció verzióját az enumerálás WS_ADDRESSING_VERSION megadott módon.