Bagikan melalui

struktur WS_ENDPOINT_ADDRESS (webservices.h)

  • Artikel

Mewakili alamat jaringan titik akhir.

Sintaks

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

Anggota

url

Bagian URL alamat.

URL selalu dalam bentuk escape.

Jika string ini panjangnya nol, maka URL diasumsikan sebagai alamat anonim. String alamat anonim secara otomatis dipetakan ke/dari string panjang nol saat alamat titik akhir diserialisasikan atau dideserialisasi menggunakan WS_ENDPOINT_ADDRESS_TYPE.

Nilai bidang ini sesuai dengan elemen Alamat dari spesifikasi WS-Addressing.

headers

Handel WS_XML_BUFFER ke sekumpulan elemen header yang mewakili parameter referensi untuk alamat titik akhir.

Header diperlukan untuk berinteraksi dengan titik akhir dengan benar. Mereka digunakan untuk lebih memenuhi syarat alamat (URL).

Header harus diperlakukan sebagai nilai buram kepada pengguna alamat titik akhir.

Lihat WsAddressMessage untuk informasi tentang cara menambahkan header ke pesan yang dikirim.

Bidang ini mungkin NULL jika tidak ada header.

Nilai bidang ini sesuai dengan konten elemen ReferenceParameters dari spesifikasi WS-Addressing.

extensions

Handel WS_XML_BUFFER ke sekumpulan elemen ekstensi. Elemen ekstensi digunakan untuk menyertakan informasi tambahan dalam alamat titik akhir. Bidang ini mungkin NULL jika tidak ada elemen ekstensi.

Nilai bidang ini sesuai dengan elemen lain yang ditentukan oleh WS-Addressing dan elemen ekstensi apa pun. Elemen harus muncul dalam urutan yang benar sesuai dengan spesifikasi, diikuti oleh elemen ekstensi. Bidang ini tidak boleh berisi elemen untuk Alamat atau ReferenceParameters, atau Identitas, karena nilai-nilai ini diwakili langsung oleh bidang lain dari struktur ini.

Jika elemen ReferenceProperties ada (seperti yang didefinisikan oleh WS_ADDRESSING_VERSION_0_9), elemen tersebut harus menjadi elemen pertama dalam WS_XML_BUFFER.

identity

Identitas keamanan titik akhir yang diwakili oleh alamat titik akhir ini.

Bidang ini sesuai dengan elemen Identitas, yang merupakan ekstensi dari spesifikasi WS-Addressing dasar.

Keterangan

Hanya bidang URL yang diperlukan (bidang lain mungkin NULL).

Persyaratan

   
Klien minimum yang didukung Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Header webservices.h