enumerasi WS_SERVICE_ENDPOINT_PROPERTY_ID (webservices.h)

  • Artikel

Setiap properti mewakili parameter opsional untuk mengonfigurasi struktur WS_SERVICE_ENDPOINT yang diberikan. Enumerasi ini digunakan dalam struktur WS_SERVICE_ENDPOINT_PROPERTY yang merupakan bagian dari WS_SERVICE_ENDPOINT.

Sintaks

typedef enum {
  WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK = 0,
  WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK = 1,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS = 2,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY = 3,
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE = 4,
  WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE = 5,
  WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES = 6,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE = 7,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE = 8,
  WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES = 9,
  WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND = 10,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE = 11,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA = 12,
  WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX = 13,
  WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS = 14
} WS_SERVICE_ENDPOINT_PROPERTY_ID;

Konstanta

 
WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK
Nilai: 0
Digunakan dengan WS_SERVICE_ENDPOINT.
Nilainya adalah penunjuk ke struktur WS_SERVICE_PROPERTY_ACCEPT_CALLBACK.
WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK
Nilai: 1
Digunakan dengan WS_SERVICE_ENDPOINT.
Nilainya adalah penunjuk ke struktur WS_SERVICE_PROPERTY_CLOSE_CALLBACK.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS
Nilai: 2
Digunakan dengan WS_SERVICE_ENDPOINT, ini menentukan jumlah maksimum host layanan saluran bersamaan
secara aktif menerima koneksi baru untuk titik akhir tertentu. Ketika tidak ditentukan, nilai ini diatur ke 1. Jika titik akhir menentukan konkurensi handler pesan default (Lihat WS_SERVICE_ENDPOINT)
harus 1.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY
Nilai: 3
Digunakan dengan WS_SERVICE_ENDPOINT, ini menentukan jumlah maksimum panggilan bersamaan yang akan dilayankan pada saluran berbasis sesi.
Ketika tidak ditentukan, nilai ini diatur ke 1. Jika titik akhir menentukan penangan pesan default (Lihat konkurensi WS_SERVICE_ENDPOINT
harus 1.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE
Nilai: 4
Ukuran timbunan maksimum untuk deserialisasi tubuh.


Ini adalah pengaturan heap yang tersedia yang digunakan untuk deserialisasi isi. Timbunan ini juga
tersedia untuk operasi layanan untuk mengalokasikan parameter.


Defaultnya adalah 65535 byte.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE
Nilai: 5
Ukuran pemangkasan timbunan untuk deserialisasi tubuh.


Ini adalah pengaturan heap yang tersedia yang digunakan untuk deserialisasi isi. Timbunan ini juga
tersedia untuk operasi layanan untuk mengalokasikan parameter.


Defaultnya adalah 4096 byte.
WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES
Nilai: 6
Properti ini memungkinkan pengguna untuk menentukan properti pesan
objek yang digunakan oleh titik akhir untuk mengirim dan menerima pesan.


Properti ini dapat ditentukan ketika host layanan dibuat.


Nilai yang ditentukan harus berjenis WS_MESSAGE_PROPERTIES.


Properti pesan berikut mungkin ditentukan:
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE
Nilai: 7
Jumlah maksimum objek layanan panggilan yang akan dikumpulkan untuk melayani objek pesan, pada objek tertentu
Endpoint. Perhatikan bahwa dalam kasus saluran berbasis sesi banyak objek panggilan dapat digunakan pada satu
jika WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY lebih besar dari 1.


Untuk saluran tanpa sesi, properti ini idealnya harus sama dengan WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE.


Defaultnya adalah 100.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE
Nilai: 8
Jumlah maksimum WS_CHANNEL yang akan dikumpulkan oleh Host Layanan pada
Endpoint.


Defaultnya adalah 100.
WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES
Nilai: 9
Properti pendengar.
WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND
Nilai: 10
Mengaktifkan atau menonaktifkan harus memahami verifikasi header pada titik akhir. Ini adalah 'TRUE' secara default.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE
Nilai: 11
Properti ini dapat diatur ke WS_METADATA_EXCHANGE_TYPE_MEX untuk diaktifkan
layanan permintaan WS-MetadataExchange pada titik akhir. Jika aplikasi ingin
mengekspos metadata melalui HTTP GET, properti ini dapat diatur ke WS_METADATA_EXCHANGE_TYPE_HTTP_GET

Jika tidak ditentukan, nilai default properti ini adalah 'WS_METADATA_EXCHANGE_TYPE_NONE'.


Perhatikan bahwa properti ini saat diatur ke WS_METADATA_EXCHANGE_TYPE_HTTP_GET mengubah properti WS_LISTENER
WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS dan
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS ke WS_MATCH_URL_PREFIX_PATH.


Saat mengatur properti ini ke WS_METADATA_EXCHANGE_TYPE_HTTP_GET aplikasi tidak boleh menentukan WS_MATCH_URL_EXACT_PATH untuk pendengar
properti WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS dan WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS untuk WS_SERVICE_ENDPOINT yang diberikan.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA
Nilai: 12
Menentukan nama port WSDL, nama pengikatan, dan namespace pengikatan untuk titik akhir.


Properti ini harus ditentukan untuk mengaktifkan partisipasi WS_SERVICE_ENDPOINT di WS-Metadata Exchange.


Lihat WS_SERVICE_ENDPOINT_METADATA untuk detail selengkapnya.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX
Nilai: 13
Menentukan akhiran yang digabungkan apa adanya ke URL WS_SERVICE_ENDPOINT untuk menghasilkan URL untuk layanan permintaan WS-MetadataExchange v1.1.
URL yang dihasilkan digunakan untuk membandingkan dengan header 'ke' dari pesan yang diterima. Perhatikan bahwa jika pesan tidak berisi header 'ke' permintaan tidak
Serviced.


Properti ini hanya boleh ditentukan jika WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE diatur ke WS_METADATA_EXCHANGE_TYPE_MEX.


Menentukan properti ini berguna dalam kasus di mana aplikasi ingin menangani permintaan WS-Transfer Get serta menggunakan titik akhir yang sama untuk layanan
WS-MetadataExchange permintaan v1.1. URL hasilkan dalam hal ini digunakan untuk memfilter WS-Transfer Dapatkan permintaan untuk Ws-MetadataExchange v1.1.


Secara default tidak ada pemfilteran yang dilakukan untuk WS-MetadataExchange v1.1 untuk MEX dan semua permintaan GET WS-Transfer akan ditangani oleh titik akhir untuk Ws-MetadataExchange v1.1, jika
Ws-MetadataExchange v1.1 diaktifkan pada titik akhir.


Perhatikan bahwa properti ini mengubah properti WS_LISTENERWS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS dan
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS ke WS_MATCH_URL_PREFIX_PATH.


Saat mengatur properti ini, aplikasi tidak boleh menentukan WS_MATCH_URL_EXACT_PATH untuk pendengar
properti WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS dan WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS
untuk WS_SERVICE_ENDPOINT yang diberikan.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS
Nilai: 14
Jumlah maksimum saluran yang dapat dilayankan pada titik akhir.


Nilai defaultnya adalah 100.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Header webservices.h