Bagikan melalui

enumerasi WS_CHANNEL_PROPERTY_ID (webservices.h)

  • Artikel

Setiap properti saluran diidentifikasi oleh ID dan memiliki nilai terkait. Jika properti tidak ditentukan saat saluran dibuat, maka nilai defaultnya digunakan.

Sintaks

typedef enum {
  WS_CHANNEL_PROPERTY_MAX_BUFFERED_MESSAGE_SIZE = 0,
  WS_CHANNEL_PROPERTY_MAX_STREAMED_MESSAGE_SIZE = 1,
  WS_CHANNEL_PROPERTY_MAX_STREAMED_START_SIZE = 2,
  WS_CHANNEL_PROPERTY_MAX_STREAMED_FLUSH_SIZE = 3,
  WS_CHANNEL_PROPERTY_ENCODING = 4,
  WS_CHANNEL_PROPERTY_ENVELOPE_VERSION = 5,
  WS_CHANNEL_PROPERTY_ADDRESSING_VERSION = 6,
  WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE = 7,
  WS_CHANNEL_PROPERTY_STATE = 8,
  WS_CHANNEL_PROPERTY_ASYNC_CALLBACK_MODEL = 9,
  WS_CHANNEL_PROPERTY_IP_VERSION = 10,
  WS_CHANNEL_PROPERTY_RESOLVE_TIMEOUT = 11,
  WS_CHANNEL_PROPERTY_CONNECT_TIMEOUT = 12,
  WS_CHANNEL_PROPERTY_SEND_TIMEOUT = 13,
  WS_CHANNEL_PROPERTY_RECEIVE_RESPONSE_TIMEOUT = 14,
  WS_CHANNEL_PROPERTY_RECEIVE_TIMEOUT = 15,
  WS_CHANNEL_PROPERTY_CLOSE_TIMEOUT = 16,
  WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS = 17,
  WS_CHANNEL_PROPERTY_TRANSFER_MODE = 18,
  WS_CHANNEL_PROPERTY_MULTICAST_INTERFACE = 19,
  WS_CHANNEL_PROPERTY_MULTICAST_HOPS = 20,
  WS_CHANNEL_PROPERTY_REMOTE_ADDRESS = 21,
  WS_CHANNEL_PROPERTY_REMOTE_IP_ADDRESS = 22,
  WS_CHANNEL_PROPERTY_HTTP_CONNECTION_ID = 23,
  WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS = 24,
  WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS = 25,
  WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_INSTANCE = 26,
  WS_CHANNEL_PROPERTY_TRANSPORT_URL = 27,
  WS_CHANNEL_PROPERTY_NO_DELAY = 28,
  WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES = 29,
  WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME = 30,
  WS_CHANNEL_PROPERTY_KEEP_ALIVE_INTERVAL = 31,
  WS_CHANNEL_PROPERTY_MAX_HTTP_SERVER_CONNECTIONS = 32,
  WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN = 33,
  WS_CHANNEL_PROPERTY_CHANNEL_TYPE = 34,
  WS_CHANNEL_PROPERTY_TRIM_BUFFERED_MESSAGE_SIZE = 35,
  WS_CHANNEL_PROPERTY_ENCODER = 36,
  WS_CHANNEL_PROPERTY_DECODER = 37,
  WS_CHANNEL_PROPERTY_PROTECTION_LEVEL = 38,
  WS_CHANNEL_PROPERTY_COOKIE_MODE = 39,
  WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE = 40,
  WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY = 41,
  WS_CHANNEL_PROPERTY_HTTP_MESSAGE_MAPPING = 42,
  WS_CHANNEL_PROPERTY_ENABLE_HTTP_REDIRECT = 43,
  WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT = 44,
  WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS = 45,
  WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS = 46,
  WS_CHANNEL_PROPERTY_HTTP_SERVER_SPN = 47,
  WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN = 48,
  WS_CHANNEL_PROPERTY_MAX_HTTP_REQUEST_HEADERS_BUFFER_SIZE = 49
} WS_CHANNEL_PROPERTY_ID;

Konstanta

 
WS_CHANNEL_PROPERTY_MAX_BUFFERED_MESSAGE_SIZE
Nilai: 0
ULONG
digunakan dengan WsCreateChannel, WsCreateChannelForListener atau
WsGetChannelProperty untuk WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING, atau WS_NAMEDPIPE_CHANNEL_BINDING. Nilai ini adalah batas seberapa besar
pesan dapat diterima atau dikirim oleh saluran. Batas menentukan ukuran maksimum
amplop dalam byte seperti yang muncul dalam bentuk kawat yang dikodekan.
Nilai minimumnya adalah 1.


Properti ini membatasi jumlah memori
yang akan dialokasikan saluran untuk menerima atau mengirim pesan yang di-buffer.
Saat menerima dengan input buffer, seluruh pesan dibaca ke dalam
buffer sebelum aplikasi memiliki akses ke aplikasi tersebut. Saat mengirim dengan output yang di-buffer,
seluruh pesan diakumulasikan dalam buffer sebelum dikirim.


Properti ini hanya dapat ditentukan ketika input atau output yang di-buffer telah
ditentukan ( baik WS_STREAMED_INPUT_TRANSFER_MODE atau
WS_STREAMED_OUTPUT_TRANSFER_MODE belum ditetapkan).


Nilai defaultnya adalah 65536.


WS_UDP_CHANNEL_BINDING selalu menggunakan nilai 65536.
WS_CHANNEL_PROPERTY_MAX_STREAMED_MESSAGE_SIZE
Nilai: 1
__int64 yang tidak ditandatangani yang digunakan dengan WsCreateChannel, WsCreateChannelForListener atau
WsGetChannelProperty
WS_HTTP_CHANNEL_BINDING. Ini
nilai adalah batas seberapa besar pesan yang dialirkan dapat diterima atau dikirim
untuk saluran.
Batas menentukan ukuran maksimum amplop dalam byte saat muncul
dalam bentuk kawat yang dikodekan. Nilai minimumnya adalah 1.


Properti ini hanya dapat ditentukan ketika input atau output yang dialirkan telah dipilih
(WS_STREAMED_INPUT_TRANSFER_MODE atau WS_STREAMED_OUTPUT_TRANSFER_MODE telah ditetapkan).


Nilai defaultnya adalah 4194304.
WS_CHANNEL_PROPERTY_MAX_STREAMED_START_SIZE
Nilai: 2
ULONG yang digunakan dengan WsCreateChannel, WsCreateChannelForListener atau
WsGetChannelProperty untuk WS_HTTP_CHANNEL_BINDING.
Nilai ini adalah batas seberapa besar awal pesan.
Awal pesan terdiri dari tag amplop, header, dan tag isi.
Batas menentukan ukuran maksimum data dalam byte seperti yang muncul di
bentuk kawat yang dikodekan. Nilai minimumnya adalah 1.


Properti ini hanya dapat ditentukan ketika input yang dialirkan telah dipilih
(WS_STREAMED_INPUT_TRANSFER_MODE).


Properti ini membatasi jumlah memori yang akan dialokasikan saluran
untuk membaca awal pesan. Untuk input streaming,
seluruh awal pesan akan dibaca ke dalam buffer sebelum aplikasi
diberi tahu bahwa awal pesan telah dibaca.


Nilai defaultnya adalah 16384.
WS_CHANNEL_PROPERTY_MAX_STREAMED_FLUSH_SIZE
Nilai: 3
ULONG yang digunakan dengan WsCreateChannel, WsCreateChannelForListener atau
WsGetChannelProperty untuk WS_HTTP_CHANNEL_BINDING.
Nilai ini adalah batas berapa banyak byte yang akan diakumulasikan
sebelum WsFlushBody dipanggil.


Properti ini hanya dapat ditentukan ketika output yang dialirkan telah dipilih
(WS_STREAMED_OUTPUT_TRANSFER_MODE).


Properti ini membatasi jumlah memori yang akan dialokasikan saluran
untuk mengakumulasi data buffer. Untuk output streaming,
saluran akan mengakumulasi data dalam buffer sampai WsFlushBody dipanggil.


Nilai defaultnya adalah 65536.
WS_CHANNEL_PROPERTY_ENCODING
Nilai: 4
Nilai WS_ENCODING
digunakan dengan WsCreateChannel, WsCreateChannelForListener atau WsGetChannelProperty untuk WS_TCP_CHANNEL_BINDING atau WS_HTTP_CHANNEL_BINDING.
Nilai ini menentukan pengodean apa yang akan digunakan untuk saluran.


Nilai default tergantung pada pengikatan:



WS_UDP_CHANNEL_BINDING selalu menggunakan nilai WS_ENCODING_XML_UTF8.
WS_CHANNEL_PROPERTY_ENVELOPE_VERSION
Nilai: 5
Nilai WS_ENVELOPE_VERSION
digunakan dengan WsCreateChannel, WsCreateChannelForListener atau WsGetChannelProperty.
Nilai ini menentukan versi amplop apa yang akan digunakan untuk saluran. The
versi amplop saluran harus cocok dengan pesan yang digunakan dengan
saluran.


Properti ini tidak didukung dengan WS_NAMEDPIPE_CHANNEL_BINDING. Saluran Pipa bernama selalu menggunakan WS_ENVELOPE_VERSION_SOAP_1_2.

Nilai default tergantung pada pengikatan:
WS_CHANNEL_PROPERTY_ADDRESSING_VERSION
Nilai: 6
Nilai WS_ADDRESSING_VERSION
digunakan dengan WsCreateChannel, WsCreateChannelForListener atau WsGetChannelProperty.
Nilai ini menentukan versi alamat apa yang akan digunakan untuk saluran. The
versi alamat saluran harus cocok dengan pesan yang digunakan dengan
saluran.


Nilai default tergantung pada pengikatan:



WS_ADDRESSING_VERSION_TRANSPORT hanya didukung untuk
WS_HTTP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE
Nilai: 7
ULONG yang digunakan dengan WsCreateChannel, WsCreateChannelForListener atau WsGetChannelProperty.
Properti ini hanya berlaku untuk WS_TCP_CHANNEL_BINDING atau WS_NAMEDPIPE_CHANNEL_BINDING.
Nilai ini menentukan kuota untuk jumlah byte kamus sesi
string yang akan dikirimkan atau diterima saat menggunakan pengodean berbasis sesi.


Satu-satunya pengodean berbasis sesi yang didukung saat ini adalah
WS_ENCODING_XML_BINARY_SESSION_1, yang merupakan pengodean default
untuk WS_TCP_CHANNEL_BINDING.


Jika kuota tercapai di sisi penerima, maka saluran
akan salah.


Jika kuota tercapai di sisi pengirim, maka saluran hanya akan
mengirimkan string tanpa menggunakan kamus sesi.


Nilai ini diabaikan jika tidak menggunakan pengodean berbasis sesi.


Nilai defaultnya adalah 2048.
WS_CHANNEL_PROPERTY_STATE
Nilai: 8
Nilai WS_CHANNEL_STATE
dikembalikan oleh WsGetChannelProperty.


Nilai yang dikembalikan adalah rekam jepret dari status saat ini, sehingga
mungkin bahwa status mungkin telah berubah sebelum pemanggil memiliki
sempat memeriksa nilainya.
WS_CHANNEL_PROPERTY_ASYNC_CALLBACK_MODEL
Nilai: 9
Nilai WS_CALLBACK_MODEL digunakan dengan WsCreateChannel atau WsGetChannelProperty.
Nilai ini menunjukkan model panggilan balik asinkron pilihan saat menerbitkan
operasi asinkron untuk saluran.


Jika menggunakan WsCreateChannelForListener lihat
WS_LISTENER_PROPERTY_ASYNC_CALLBACK_MODEL.


Defaultnya adalah WS_LONG_CALLBACK.


Baik WS_SERVICE_HOST maupun WS_SERVICE_PROXY hanya mendukung WS_LONG_CALLBACK
sebagai nilai yang dapat diterima untuk properti ini.
WS_CHANNEL_PROPERTY_IP_VERSION
Nilai: 10
Nilai WS_IP_VERSION
digunakan dengan WsCreateChannel atau WsGetChannelProperty untuk WS_TCP_CHANNEL_BINDING atau WS_UDP_CHANNEL_BINDING.
Properti ini menentukan versi IP mana yang harus digunakan saluran
berkomunikasi dengan titik akhir jarak jauh.


Untuk menentukan versi IP yang akan digunakan untuk saluran yang diterima, gunakan
WS_LISTENER_PROPERTY_IP_VERSION properti pendengar saat
membuat objek pendengar.


Nilai defaultnya adalah WS_IP_VERSION_AUTO.
WS_CHANNEL_PROPERTY_RESOLVE_TIMEOUT
Nilai: 11
ULONG yang digunakan dengan WsCreateChannel, WsSetChannelProperty,
atau WsSetChannelProperty untuk WS_HTTP_CHANNEL_BINDING dan WS_CHANNEL_TYPE_REQUEST.
Batas waktu ini membatasi jumlah waktu yang akan dihabiskan untuk menyelesaikan
nama DNS. Nilai batas waktu dalam milidetik,
di mana nilai INFINITE menunjukkan tidak ada batas waktu.


Properti ini dapat diatur dalam status saluran apa pun.


Nilai defaultnya adalah INFINITE.
WS_CHANNEL_PROPERTY_CONNECT_TIMEOUT
Nilai: 12
ULONG yang digunakan dengan WsCreateChannel,
WsSetChannelProperty, atau WsGetChannelProperty
untuk WS_TCP_CHANNEL_BINDING atau WS_NAMEDPIPE_CHANNEL_BINDING di sisi klien.
Batas waktu ini membatasi jumlah waktu yang akan dihabiskan untuk terhubung ke komputer jarak jauh dan menyelesaikan jabat tangan net.tcp atau net.pipe. Nilai batas waktu
dalam milidetik, di mana nilai INFINITE menunjukkan tidak ada batas waktu. Untuk mengatur
atau mendapatkan batas waktu yang sesuai di sisi server, gunakan
(WS_LISTENER_PROPERTY_CONNECT_TIMEOUT).


Digunakan dengan WsCreateChannel,
WsSetChannelProperty, atau WsGetChannelProperty untuk WS_HTTP_CHANNEL_BINDING dan WS_CHANNEL_TYPE_REQUEST.
Batas waktu ini membatasi jumlah waktu yang akan dihabiskan untuk terhubung
ke server HTTP. Nilai batas waktu dalam milidetik,
di mana nilai INFINITE menunjukkan tidak ada batas waktu.


Properti ini dapat diatur dalam status saluran apa pun.


Nilai defaultnya adalah 30000 (30 detik).


WS_SERVICE_PROXY mengatur batas waktu ini ke INFINITE secara default.
WS_CHANNEL_PROPERTY_SEND_TIMEOUT
Nilai: 13
ULONG yang digunakan dengan WsCreateChannel, WsCreateChannelForListener,
WsSetChannelProperty, atau WsGetChannelProperty
untuk WS_TCP_CHANNEL_BINDING atau WS_NAMEDPIPE_CHANNEL_BINDING. Batas waktu ini membatasi
jumlah waktu yang akan dihabiskan untuk mengirim byte pesan.
Nilai batas waktu dalam milidetik, di mana nilai yang ditunjukkan INFINITE
tidak ada batas waktu.


Digunakan dengan WsCreateChannel, WsSetChannelProperty,
atau WsGetChannelProperty untuk WS_HTTP_CHANNEL_BINDING
dan WS_CHANNEL_TYPE_REQUEST.
Batas waktu ini membatasi jumlah waktu yang akan dihabiskan untuk
Header HTTP dan byte pesan. Nilai waktu habis dalam milidetik, di mana
nilai INFINITE menunjukkan tidak ada batas waktu.


Properti ini dapat diatur dalam status saluran apa pun.


Nilai defaultnya adalah 30000 (30 detik).


Baik WS_SERVICE_HOST maupun WS_SERVICE_PROXY mengatur ini
batas waktu ke INFINITE secara default.
WS_CHANNEL_PROPERTY_RECEIVE_RESPONSE_TIMEOUT
Nilai: 14
ULONG yang digunakan dengan WsCreateChannel, WsSetChannelProperty,
atau WsSetChannelProperty untuk WS_HTTP_CHANNEL_BINDING dan WS_CHANNEL_TYPE_REQUEST.
Batas waktu ini membatasi jumlah waktu yang akan dihabiskan untuk menunggu
semua header respons yang akan diterima dari server.
Nilai batas waktu dalam milidetik, di mana nilai INFINITE menunjukkan tidak ada batas waktu.


Properti ini dapat diatur dalam status saluran apa pun.


Nilai defaultnya adalah 30000 (30 detik).


WS_SERVICE_PROXY mengatur batas waktu ini ke INFINITE.
WS_CHANNEL_PROPERTY_RECEIVE_TIMEOUT
Nilai: 15
ULONG yang digunakan dengan WsCreateChannel, WsCreateChannelForListener,
WsSetChannelProperty, atau WsGetChannelProperty,
untuk WS_TCP_CHANNEL_BINDING atau WS_NAMEDPIPE_CHANNEL_BINDING.
Batas waktu ini membatasi jumlah waktu yang akan dihabiskan untuk menerima
byte pesan.
Nilai batas waktu dalam milidetik, di mana nilai yang ditunjukkan INFINITE
tidak ada batas waktu.


Digunakan dengan WsCreateChannel, WsSetChannelProperty,
atau WsGetChannelProperty untuk WS_HTTP_CHANNEL_BINDING dan WS_CHANNEL_TYPE_REQUEST.
Batas waktu ini membatasi jumlah waktu yang akan dihabiskan untuk menerima
byte pesan. Nilai batas waktu dalam milidetik,
di mana nilai INFINITE menunjukkan tidak ada batas waktu.
Batas waktu ini dapat dipicu oleh WsWriteMessageEnd, WsReadMessageStart, dan WsReadMessageEnd.

Properti ini dapat diatur dalam status saluran apa pun.


Nilai defaultnya adalah 30000 (30 detik).


Baik WS_SERVICE_HOST maupun WS_SERVICE_PROXY mengatur ini
batas waktu ke INFINITE secara default.
WS_CHANNEL_PROPERTY_CLOSE_TIMEOUT
Nilai: 16
ULONG yang digunakan dengan WsCreateChannel, WsCreateChannelForListener
WsSetChannelProperty, atau WsGetChannelProperty
untuk WS_TCP_CHANNEL_BINDING atau WS_NAMEDPIPE_CHANNEL_BINDING.
Batas waktu ini membatasi jumlah waktu yang akan dihabiskan untuk menyelesaikan
jabat tangan net.tcp atau net.pipe. Nilai waktu habis dalam milidetik, di mana
nilai INFINITE menunjukkan tidak ada batas waktu.


Properti ini dapat diatur dalam status saluran apa pun.


Nilai defaultnya adalah 30000 (30 detik).


WS_SERVICE_PROXY mengatur batas waktu ini ke INFINITE secara default.
WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS
Nilai: 17
BOOL yang digunakan dengan WsCreateChannel untuk WS_HTTP_CHANNEL_BINDING, WS_TCP_CHANNEL_BINDING, WS_NAMEDPIPE_CHANNEL_BINDING,
dan WS_UDP_CHANNEL_BINDING.
Digunakan dengan WsGetChannelProperty untuk WS_CUSTOM_CHANNEL_BINDING.


Ketika properti ini diatur ke TRUE atau tidak disediakan saat memanggil WsCreateChannel,
properti batas waktu saluran yang lebih spesifik (misalnya WS_CHANNEL_PROPERTY_SEND_TIMEOUT)
lebih diutamakan dan berpura-pura seperti yang di dokumentasikan. Ketika properti ini diatur ke FALSE,
semua properti batas waktu saluran tertentu diatur ke INFINITE kecuali ditentukan secara eksplisit.


Properti ini dapat dikueri dari saluran kustom menggunakan WsGetChannelProperty,
lihat WS_GET_CHANNEL_PROPERTY_CALLBACK untuk detail selengkapnya.


Nilai defaultnya adalah TRUE.


Untuk menerapkan logika batas waktu mereka sendiri, WS_SERVICE_PROXY dan
WS_SERVICE_HOST mengatur properti ini ke FALSE untuk
pengikatan saluran standar dan memerlukan saluran kustom untuk mendukungnya dengan mengkueri dan
memverifikasi bahwa itu diatur ke FALSE.
Properti batas waktu yang lebih spesifik masih dapat disediakan seperti yang dijelaskan di atas.
WS_CHANNEL_PROPERTY_TRANSFER_MODE
Nilai: 18
Nilai WS_TRANSFER_MODE
digunakan dengan WsCreateChannel
untuk WS_HTTP_CHANNEL_BINDING mengontrol apakah pesan
dikirim dan diterima di saluran di-buffer atau dialirkan. Klien
dan server dapat menggunakan mode transfer yang berbeda dan masih dapat berkomunikasi.


Semua saluran mendukung WsGetChannelProperty untuk ini
Properti.


Untuk pengikatan saluran selain WS_HTTP_CHANNEL_BINDINGnilainya selalu WS_BUFFERED_TRANSFER_MODE.


Nilai properti default adalah WS_BUFFERED_TRANSFER_MODE. Catatan
hanya WS_BUFFERED_TRANSFER_MODE yang digunakan oleh Model Layanan untuk keduanya
WS_SERVICE_PROXY dan WS_SERVICE_HOST. Satu-satunya pengecualian
menggunakan kontrak pesan pada WS_SERVICE_HOST, di mana
WS_STREAMED_OUTPUT_TRANSFER_MODE diperbolehkan.



WS_STREAMED_OUTPUT_TRANSFER_MODE dengan WS_CHANNEL_TYPE_REQUEST memerlukan Windows Vista ke atas, dan hanya mendukung WS_HTTP_HEADER_AUTH_SCHEME_BASIC ketika digunakan dengan keamanan.
WS_CHANNEL_PROPERTY_MULTICAST_INTERFACE
Nilai: 19
ULONG yang digunakan dengan WsCreateChannel, WsSetChannelProperty,
atau WsGetChannelProperty untuk WS_UDP_CHANNEL_BINDING
dengan WS_CHANNEL_TYPE_DUPLEX untuk menunjukkan adaptor mana
harus digunakan saat mengirim ke alamat multicast.


Nilainya adalah indeks antarmuka adaptor.


Jika properti ini tidak diatur, atau adalah 0, maka adaptor default untuk
mesin digunakan. Ini mungkin tidak sesuai untuk mesin dengan beberapa adaptor.


Properti ini dapat diatur dalam status saluran apa pun.


Nilai properti default adalah 0.
WS_CHANNEL_PROPERTY_MULTICAST_HOPS
Nilai: 20
ULONG yang digunakan dengan WsCreateChannel atau WsGetChannelProperty
untuk WS_UDP_CHANNEL_BINDING dengan WS_CHANNEL_TYPE_DUPLEX
untuk menentukan jumlah hop maksimum yang dapat dilalui pesan UDP.


Nilai properti default adalah 1.
WS_CHANNEL_PROPERTY_REMOTE_ADDRESS
Nilai: 21
Struktur WS_ENDPOINT_ADDRESS
digunakan dengan WsGetChannelProperty
untuk WS_UDP_CHANNEL_BINDING dengan WS_CHANNEL_TYPE_DUPLEX
untuk mengambil alamat titik akhir pihak jarak jauh untuk saluran.


Bidang yang dikembalikan
WS_ENDPOINT_ADDRESS struktur valid dan konstan hingga saluran
diatur ulang atau dikosongkan. Pemanggil tidak boleh mengubah nilai yang dikembalikan
bidang WS_ENDPOINT_ADDRESS menunjuk ke.


Properti ini tidak dapat diambil sampai saluran telah mencapai status terbuka.


Properti ini didasarkan pada alamat IP sumber yang diterima dari
jaringan, yang dapat di-spoofed atau dirusak meskipun menggunakan
saluran aman (tergantung pada lingkungan jaringan).
WS_CHANNEL_PROPERTY_REMOTE_IP_ADDRESS
Nilai: 22
Struktur SOCKADDR_STORAGE
digunakan dengan WsCreateChannel
untuk jenis saluran berikut untuk mengambil alamat IP
dari pihak jarak jauh:



Properti ini tidak dapat diambil sampai saluran mulai membaca pesan.


Properti ini didasarkan pada alamat IP sumber yang diterima dari
jaringan, yang dapat di-spoofed atau dirusak meskipun menggunakan
saluran aman (tergantung pada lingkungan jaringan).
WS_CHANNEL_PROPERTY_HTTP_CONNECTION_ID
Nilai: 23
Penunjuk ke ULONGLONG yang digunakan dengan WsGetChannelProperty
untuk WS_HTTP_CHANNEL_BINDING dengan WS_CHANNEL_TYPE_REPLY
untuk mengambil pengidentifikasi yang secara unik mengidentifikasi koneksi klien.


Properti ini tidak dapat diambil sampai saluran mulai membaca pesan.


ID koneksi secara unik mengidentifikasi koneksi saat
objek pendengar yang diterima saluran dari tetap terbuka.


Instans saluran balasan yang diberikan sama sekali tidak berkorelasi dengan koneksi.
Setiap kali saluran diterima, mungkin ada ID koneksi yang berbeda
(bahkan jika kumpulan total koneksi tidak berubah sejak penerimaan terakhir).


ID koneksi dapat digunakan oleh aplikasi untuk menghubungkan status dengan
koneksi HTTP.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
Nilai: 24
Struktur WS_CUSTOM_CHANNEL_CALLBACKS digunakan dengan WsCreateChannel atau WsCreateChannelForListener untuk WS_CUSTOM_CHANNEL_BINDING.


Properti ini digunakan untuk menentukan panggilan balik yang
menentukan implementasi saluran kustom.


Properti ini harus ditentukan ketika WS_CUSTOM_CHANNEL_BINDING digunakan.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
Nilai: 25
Penunjuk ke jenis data berukuran arbitrer yang digunakan dengan WsCreateChannel atau WsCreateChannelForListener untuk WS_CUSTOM_CHANNEL_BINDING.


Properti ini digunakan untuk menentukan parameter yang digunakan untuk membuat kustom
implementasi saluran.


Ukuran properti adalah ukuran jenis data.


Nilai properti ini akan diteruskan ke
WS_CREATE_CHANNEL_CALLBACK.


Jika properti ini tidak ditentukan, nilainya adalah NULL dan ukurannya adalah nol.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_INSTANCE
Nilai: 26
Kekosongan yang digunakan dengan WsGetChannelProperty untuk WS_CUSTOM_CHANNEL_BINDING.


Ukuran properti adalah sizeof(void).
Nilai sesuai dengan nilai instans saluran yang dikembalikan oleh
WS_CREATE_CHANNEL_CALLBACK.


Properti ini dapat digunakan untuk mendapatkan saluran yang mendasar
instans untuk saluran kustom. Ini memungkinkan penelepon untuk secara langsung
berinteraksi dengan instans untuk kasus saat yang ada
set properti saluran atau fungsi saluran tidak cukup.
WS_CHANNEL_PROPERTY_TRANSPORT_URL
Nilai: 27
Struktur WS_STRING
digunakan dengan WsGetChannelProperty
untuk WS_HTTP_CHANNEL_BINDING atau WS_TCP_CHANNEL_BINDING untuk saluran yang dibuat dengan WsCreateChannelForListener.


Properti ini digunakan pada server untuk mendapatkan URL yang diteruskan
ke WsOpenChannel pada klien.
URL ini mungkin berbeda dari nilai dalam WS_TO_HEADER
jika WsAddressMessage digunakan. Pemetaan
url transportasi ke transportasi yang mendasarinya bervariasi menurut
WS_CHANNEL_BINDING, sebagai berikut:



Properti ini hanya tersedia setelah saluran memiliki
diterima menggunakan WsAcceptChannel.


Pemanggil harus meneruskan alamat WS_STRING ketika
mengambil properti ini. String yang dikembalikan adalah string yang sepenuhnya memenuhi syarat
URL dalam formulir yang dikodekan. String yang dikembalikan bagus sampai saluran
dikosongkan atau direset.
WS_CHANNEL_PROPERTY_NO_DELAY
Nilai: 28
BOOL yang digunakan dengan WsCreateChannel, WsCreateChannelForListener atau WsGetChannelProperty atau WsSetChannelProperty untuk WS_TCP_CHANNEL_BINDING.


Properti ini mengontrol nilai opsi soket TCP_NODELAY dari soket yang mendasar.


Ketika nilai ini FALSE, algoritma Nagle digunakan yang dapat
meningkatkan throughput dengan menggabungkan pesan kecil.


Mengatur nilai ini ke TRUE dapat mengurangi latensi dengan biaya throughput
untuk pesan kecil.


Nilai defaultnya adalah FALSE.
WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES
Nilai: 29
BOOL yang digunakan dengan WsCreateChannel, WsCreateChannelForListener untuk WS_TCP_CHANNEL_BINDING.


Properti ini mengontrol nilai opsi soket SO_KEEPALIVE dari soket yang mendasar.


Mengatur nilai ini ke TRUE akan menyebabkan paket tetap hidup dikirim
pada soket yang mendasar, yang dapat membantu mendeteksi kapan
pihak jarak jauh tidak lagi tersedia.


Nilai defaultnya adalah FALSE.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME
Nilai: 30
ULONG yang digunakan dengan WsCreateChannel atau WsCreateChannelForListener untuk WS_TCP_CHANNEL_BINDING.


Properti ini diukur dalam milidetik.


Properti ini hanya dapat ditentukan ketika properti WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES memiliki nilai TRUE.


Nilai menunjukkan jumlah waktu sebelum mengirim paket tetap hidup jika
soket tidak digunakan.


Nilai defaultnya adalah 2 jam.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_INTERVAL
Nilai: 31
ULONG yang digunakan dengan WsCreateChannel atau WsCreateChannelForListener untuk WS_TCP_CHANNEL_BINDING.


Properti ini diukur dalam milidetik.


Properti ini hanya dapat ditentukan ketika properti WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES memiliki nilai TRUE.


Setelah waktu yang ditentukan dalam WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME telah kedaluwarsa,
sistem akan mulai mengirim paket tetap hidup dalam upaya untuk menghubungi
pihak terpencil. Pengaturan ini mengontrol seberapa sering sistem akan mengirim
paket lain (sebagai upaya coba lagi).


Nilai default adalah 1 detik.
WS_CHANNEL_PROPERTY_MAX_HTTP_SERVER_CONNECTIONS
Nilai: 32
ULONG yang digunakan dengan WsCreateChannel untuk WS_HTTP_CHANNEL_BINDING.


Properti ini menentukan jumlah maksimum koneksi yang diterapkan aplikasi klien
mungkin bertentangan dengan server HTTP.
Koneksi dapat di-cache dan digunakan kembali oleh komponen lain dalam proses yang sama mengakses server HTTP yang sama.


Nilai defaultnya adalah INFINITE (tanpa batas).
WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN
Nilai: 33
BOOL yang digunakan dengan WsGetChannelProperty untuk WS_TCP_CHANNEL_BINDING
atau WS_NAMEDPIPE_CHANNEL_BINDING dengan WS_CHANNEL_TYPE_DUPLEX_SESSION.


Properti ini menunjukkan
apakah WsShutdownSessionChannel telah
digunakan untuk mematikan saluran.


Saluran harus dalam WS_CHANNEL_STATE_OPEN atau
WS_CHANNEL_STATE_FAULTED .
WS_CHANNEL_PROPERTY_CHANNEL_TYPE
Nilai: 34
Nilai WS_CHANNEL_TYPE
digunakan dengan WsGetChannelProperty untuk semua jenis saluran
untuk mengkueri jenis saluran.


Saluran dapat berada di WS_CHANNEL_STATE apa pun.
WS_CHANNEL_PROPERTY_TRIM_BUFFERED_MESSAGE_SIZE
Nilai: 35
ULONG yang digunakan dengan WsCreateChannel, WsCreateChannelForListener atau
WsGetChannelProperty untuk WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING, atau WS_NAMEDPIPE_CHANNEL_BINDING untuk mengontrol alokasi memori
karakteristik untuk pesan di saluran.


Properti ini menentukan jumlah maksimum memori yang akan disimpan saluran
sekitar setelah pesan diatur ulang. Jika semua
pesan yang dilihat saluran semuanya lebih kecil dari ukuran ini, lalu alokasi
untuk tujuan buffering pesan akan diminimalkan.


Properti ini hanya dapat ditentukan ketika input atau output yang di-buffer telah
ditentukan ( baik WS_STREAMED_INPUT_TRANSFER_MODE atau
WS_STREAMED_OUTPUT_TRANSFER_MODE belum ditetapkan).


Nilai defaultnya adalah 65536.


WS_UDP_CHANNEL_BINDING selalu menggunakan nilai 65536.
WS_CHANNEL_PROPERTY_ENCODER
Nilai: 36
Struktur WS_CHANNEL_ENCODER digunakan dengan WsCreateChannel atau WsCreateChannelForListener untuk WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING, atau WS_NAMEDPIPE_CHANNEL_BINDING untuk menyediakan pengodean pesan kustom.

Properti ini tidak dapat digunakan dengan WS_UDP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_DECODER
Nilai: 37
Struktur WS_CHANNEL_DECODER digunakan dengan WsCreateChannel atau WsCreateChannelForListener untuk WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING, atau WS_NAMEDPIPE_CHANNEL_BINDING untuk menyediakan dencoding pesan kustom.

Properti ini tidak dapat digunakan dengan WS_UDP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_PROTECTION_LEVEL
Nilai: 38
Nilai WS_PROTECTION_LEVEL digunakan dengan WsGetChannelProperty untuk jenis saluran apa pun.


Properti ini menunjukkan
jaminan keamanan yang disediakan oleh saluran.


Nilai properti ini tergantung pada persyaratan keamanan
diminta untuk saluran.
WS_CHANNEL_PROPERTY_COOKIE_MODE
Nilai: 39
Nilai WS_COOKIE_MODE digunakan dengan WsCreateChannel dengan WS_HTTP_CHANNEL_BINDING untuk mengontrol bagaimana cookie HTTP ditangani.


Nilai defaultnya adalah WS_AUTO_COOKIE_MODE.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE
Nilai: 40
Nilai WS_HTTP_PROXY_SETTING_MODE digunakan dengan WsCreateChannel dengan WS_HTTP_CHANNEL_BINDING untuk mengontrol pengaturan proksi HTTP untuk saluran.


Nilai defaultnya adalah WS_HTTP_PROXY_SETTING_MODE_AUTO.
WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY
Nilai: 41
Struktur WS_CUSTOM_HTTP_PROXY digunakan dengan WsCreateChannel dengan WS_HTTP_CHANNEL_BINDING untuk menentukan pengaturan kustom untuk saluran HTTP. Properti ini harus
ditentukan ketika WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE diatur ke
WS_HTTP_PROXY_SETTING_MODE_CUSTOM.


Nilai defaultnya adalah NULL.
WS_CHANNEL_PROPERTY_HTTP_MESSAGE_MAPPING
Nilai: 42
Struktur WS_HTTP_MESSAGE_MAPPING digunakan dengan WsCreateChannel atau WsCreateChannelForListener untuk WS_HTTP_CHANNEL_BINDING.


Nilai properti ini mengontrol bagaimana permintaan atau respons HTTP dipetakan ke dalam
objek pesan. Lihat WS_HTTP_MESSAGE_MAPPING untuk informasi selengkapnya.


Nilai default untuk properti ini adalah struktur WS_HTTP_MESSAGE_MAPPING adalah sebagai berikut:



  • requestMappingOptions: 0

  • requestHeaderMappings: none

  • responseMappingOptions: 0

  • responseHeaderMappings: none



WS_HTTP_MESSAGE_MAPPING bidang requestMappingOptions dan responseMappingOptions harus 0
kecuali pengodean diatur ke WS_ENCODING_RAW menggunakan WS_CHANNEL_PROPERTY_ENCODING properti saluran.
WS_CHANNEL_PROPERTY_ENABLE_HTTP_REDIRECT
Nilai: 43
BOOL yang digunakan dengan WsCreateChannel untuk WS_HTTP_CHANNEL_BINDING dengan WS_CHANNEL_TYPE_REQUEST.


Nilai properti ini mengontrol apakah pengalihan otomatis HTTP diaktifkan.


Mengatur nilai ini ke TRUE memungkinkan pengalihan otomatis HTTP.


Nilai defaultnya adalah FALSE.
Jika properti WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT ditentukan,
properti ini diabaikan.
WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT
Nilai: 44
Struktur WS_HTTP_REDIRECT_CALLBACK_CONTEXT
digunakan dengan WsCreateChannel untuk WS_HTTP_CHANNEL_BINDING dengan WS_CHANNEL_TYPE_REQUEST.


Nilai properti ini dapat ditentukan ketika kontrol pengalihan HTTP otomatis yang lebih terperinci diperlukan.


Ketika properti ini diatur, rutinitas panggilan balik yang ditentukan akan dipanggil dengan URL titik akhir asli
dan URL baru tempat pesan akan diteruskan. Nilai pengembalian panggilan balik digunakan untuk menunjukkan apakah
pengalihan harus diizinkan.
WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS
Nilai: 45
BOOL yang digunakan dengan WsCreateChannel, WsSetChannelProperty,
WsGetChannelProperty atau WsCreateServiceProxy untuk WS_HTTP_CHANNEL_BINDING dan WS_CHANNEL_TYPE_REQUEST, atau WS_TCP_CHANNEL_BINDING, WS_NAMEDPIPE_CHANNEL_BINDING, dan WS_UDP_CHANNEL_BINDING pada klien.


Ketika diatur ke TRUE, fungsi Model Saluran dan Layanan mengembalikan kode kesalahan saat kesalahan diterima.
Jika kesalahan dikenali oleh runtime ini, kode kesalahan yang sesuai dikembalikan,
jika tidak , WS_E_ENDPOINT_FAULT_RECEIVED dikembalikan. (Lihat Nilai Pengembalian Windows Web Services.) Ketika diatur ke FALSE, WsReceiveMessage
dan WsRequestReply mengembalikan WS_E_ENDPOINT_FAULT_RECEIVED ketika kesalahan diterima.
Fungsi saluran lainnya mengembalikan kesalahan sebagai pesan reguler dan WS_MESSAGE_PROPERTY_IS_FAULT
dapat digunakan untuk membedakan kesalahan dari pesan lain.


Ketika properti ini diatur ke TRUE dan digunakan dengan WsCreateChannel atau WsSetChannelProperty,
ini mengambil alih perilaku WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS berikut: jika kesalahan diakui oleh
runtime, kesalahan yang tidak aman tidak akan menyebabkan verifikasi keamanan pesan kesalahan gagal meskipun
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS diatur ke FALSE. Status verifikasi keamanan
dapat ditentukan dengan memeriksa WS_MESSAGE_PROPERTY_PROTECTION_LEVEL.
Ini tidak berlaku untuk WS_UDP_CHANNEL_BINDING karena tidak mendukung keamanan.


Ketika properti ini diatur ke FALSE atau digunakan dengan WsCreateServiceProxy atau kesalahan tidak dikenali
oleh runtime, perilaku yang dijelaskan dalam WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS berlaku tanpa
pengecualian.


Terlepas dari nilai properti ini, jika kode kesalahan dikembalikan sebagai akibat dari menerima kesalahan,
WsGetFaultErrorProperty dapat digunakan untuk mengkueri detail kesalahan dari objek kesalahan.


Properti ini dapat diatur dalam status saluran apa pun.


Nilai defaultnya adalah TRUE. Jika digunakan dengan WsCreateServiceProxy, properti ini harus diatur ke TRUE.




Mengatur properti ini ke TRUE dapat menyebabkan verifikasi keamanan pesan dinonaktifkan karena kesalahan tertentu.
Kesalahan yang belum diverifikasi mungkin tidak dapat dipercaya.
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS
Nilai: 46
BOOL yang digunakan dengan WsCreateChannel, WsSetChannelProperty,
atau WsGetChannelProperty untuk WS_HTTP_CHANNEL_BINDING dan WS_CHANNEL_TYPE_REQUEST, atau WS_TCP_CHANNEL_BINDING dan WS_NAMEDPIPE_CHANNEL_BINDING pada klien.


Ketika diatur ke TRUE, kesalahan tidak aman yang diterima pada saluran aman tidak menyebabkan verifikasi keamanan pesan gagal. Sebaliknya,
kesalahan akan diperlakukan seolah-olah verifikasi keamanan pesan berhasil dan ditangani seperti yang dijelaskan dalam WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS.
Status verifikasi keamanan dapat ditentukan dengan memeriksa WS_MESSAGE_PROPERTY_PROTECTION_LEVEL.


Saat diatur ke FALSE, verifikasi keamanan pesan pesan kesalahan ditangani seperti verifikasi pesan lainnya.


WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS dapat mengambil alih properti ini karena kesalahan yang dikenali oleh runtime ini.


Properti ini hanya berlaku untuk verifikasi keamanan tingkat pesan dan tidak berdampak pada keamanan transportasi.


Properti ini dapat diatur dalam status saluran apa pun.


Nilai defaultnya adalah FALSE.


Mengatur properti ini ke TRUE menyebabkan verifikasi keamanan pesan untuk kesalahan dinonaktifkan. Kesalahan yang tidak aman mungkin tidak dapat dipercaya.
WS_CHANNEL_PROPERTY_HTTP_SERVER_SPN
Nilai: 47
Penunjuk WCHAR
digunakan dengan WsGetChannelProperty untuk WS_HTTP_CHANNEL_BINDING dan WS_CHANNEL_TYPE_REQUEST.



Mengembalikan Nama Utama Server dari titik akhir jarak jauh yang digunakan untuk permintaan terakhir yang gagal. Tidak ada jaminan bahwa properti ini
yang tersedia. Berikut ini adalah kondisi yang diperlukan (tetapi tidak selalu cukup) agar properti ini ada:

  • Saluran mengirim permintaan.

  • Permintaan gagal karena skema autentikasi header HTTP yang tidak cocok. Lihat WS_HTTP_HEADER_AUTH_SECURITY_BINDING.

  • Titik akhir jarak jauh mendukung skema autentikasi "Nego2".




Properti ini hanya tersedia di Windows 7 ke atas.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN
Nilai: 48
Pointer WCHAR yang digunakan dengan WsGetChannelProperty untuk WS_HTTP_CHANNEL_BINDING dan WS_CHANNEL_TYPE_REQUEST.



Mengembalikan Nama Utama Server dari server proksi HTTP yang digunakan untuk permintaan terakhir yang gagal. Tidak ada jaminan bahwa properti ini
yang tersedia. Berikut ini adalah kondisi yang diperlukan (tetapi tidak selalu cukup) agar properti ini ada:

  • Saluran mengirim permintaan.

  • Permintaan gagal karena skema autentikasi header HTTP yang tidak cocok. Lihat WS_HTTP_HEADER_AUTH_SECURITY_BINDING.

  • Server proksi HTTP mendukung skema autentikasi "Nego2".




Properti ini hanya tersedia di Windows 7 ke atas.
WS_CHANNEL_PROPERTY_MAX_HTTP_REQUEST_HEADERS_BUFFER_SIZE
Nilai: 49
ULONG yang digunakan dengan WsCreateChannelForListener atau
WsGetChannelProperty untuk WS_HTTP_CHANNEL_BINDING
dengan WS_CHANNEL_TYPE_REPLY. Nilai ini adalah batas seberapa besar header
permintaan HTTP yang sedang diterima dapat. Batas menentukan ukuran maksimum
header permintaan HTTP dalam byte.


Properti ini membatasi jumlah memori
bahwa WS_HTTP_CHANNEL_BINDING dengan WS_CHANNEL_TYPE_REPLY
akan mengalokasikan untuk menerima header permintaan HTTP. Saat menerima, seluruh permintaan HTTP
header dibaca ke dalam buffer sebelum diproses.


Nilai defaultnya adalah 65536.

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