Alamat Titik Akhir

Alamat titik akhir mewakili alamat layanan di jaringan. Ketika Anda membuka saluran, dengan memanggil fungsi WsOpenChannel , Anda perlu memberikan alamat titik akhir layanan yang akan Anda komunikasikan, serta menentukan saluran yang ingin Anda buka.

Alamat titik akhir terdiri dari:

• URL
• sekumpulan header (opsional)
• satu set ekstensi (opsional)
• identitas opsional yang mewakili identitas keamanan layanan.

Saat pesan ditangani, URL menjadi header "Kepada" dari pesan. Header apa pun yang merupakan bagian dari alamat titik akhir juga ditambahkan ke pesan.

Saluran secara otomatis mengatasi pesan apa pun yang dikirim, menggunakan struktur WS_ENDPOINT_ADDRESS yang diteruskan ke WsOpenChannel. Anda juga dapat menggunakan fungsi WsAddressMessage untuk mengambil alih perilaku default ini.

Ketika WS_ENDPOINT_ADDRESS diteruskan sebagai parameter, fungsi WsOpenChannel dan WsOpenServiceProxy membuat salinan parameter WS_ENDPOINT_ADDRESS dalam memori dan ukurannya dibatasi oleh 65536 byte. WsAddressMessage tidak memiliki batasan ini karena tidak memerlukan pembuatan salinan parameter WS_ENDPOINT_ADDRESS .

Ekstensi yang ditentukan dalam bidang ekstensiWS_ENDPOINT_ADDRESS tidak digunakan untuk mengatasi pesan tetapi sebaliknya adalah mekanisme ekstensibilitas yang dapat digunakan untuk memberikan informasi tambahan (misalnya, metadata) tentang layanan. Ekstensi umum dapat dibaca dengan fungsi WsReadEndpointAddressExtension .

Bidang identitas opsional dari alamat titik akhir dapat mencakup, misalnya, nama DNS komputer tempat layanan berjalan, atau UPN akun Windows tempat layanan berjalan. Bidang identitas tidak digunakan dalam mengatasi pesan, tetapi dapat digunakan untuk mendapatkan token keamanan untuk layanan (misalnya, untuk mendapatkan tiket Kerberos ke UPN target) dan untuk memverifikasi identitas balasan layanan (misalnya, identitas DNS yang digunakan untuk pemeriksaan nama pada sertifikat layanan yang dikembalikan selama SSL).

Alamat titik akhir dapat dibaca dan ditulis menggunakan serialisasi dengan nilai enumerasi WS_ENDPOINT_ADDRESS_TYPE dari WS_TYPE. Catatan untuk membuat serial alamat titik akhir, Anda harus mengetahui versi spesifikasi yang digunakan untuk header alamat, seperti yang ditentukan dalam enumerasi WS_ADDRESSING_VERSION .