Freigeben über


WS_CHANNEL_PROPERTY_ID-Enumeration (webservices.h)

Jede Kanaleigenschaft wird durch eine ID identifiziert und verfügt über einen zugeordneten Wert. Wenn beim Erstellen des Kanals keine Eigenschaft angegeben wird, wird ihr Standardwert verwendet.

Syntax

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;

Konstanten

 
WS_CHANNEL_PROPERTY_MAX_BUFFERED_MESSAGE_SIZE
Wert: 0
Ein ULONG
wird mit WsCreateChannel, WsCreateChannelForListener oder verwendet
WsGetChannelProperty für WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING oder WS_NAMEDPIPE_CHANNEL_BINDING. Dieser Wert ist ein Grenzwert für die Größe eines
Die Nachricht kann vom Kanal empfangen oder gesendet werden. Der Grenzwert gibt die maximale Größe an.
des Umschlags in Bytes, wie er in seiner codierten Drahtform angezeigt wird.
Der Mindestwert beträgt 1.


Diese Eigenschaft schränkt die Menge des Arbeitsspeichers ein.
die der Kanal ordnet zu, um eine gepufferte Nachricht zu empfangen oder zu senden.
Beim Empfang mit gepufferter Eingabe wird die gesamte Nachricht in ein
puffern, bevor die Anwendung Zugriff darauf hat. Beim Senden mit gepufferter Ausgabe
die gesamte Nachricht wird in einem Puffer gesammelt, bevor sie gesendet wird.


Diese Eigenschaft kann nur angegeben werden, wenn gepufferte Eingabe oder Ausgabe
angegeben ( entweder WS_STREAMED_INPUT_TRANSFER_MODE oder
WS_STREAMED_OUTPUT_TRANSFER_MODE nicht festgelegt wurden).


Der Standardwert ist 65536.


Die WS_UDP_CHANNEL_BINDING verwendet immer den Wert 65536.
WS_CHANNEL_PROPERTY_MAX_STREAMED_MESSAGE_SIZE
Wert: 1
Ein nicht signierter __int64 mit WsCreateChannel, WsCreateChannelForListener oder
WsGetChannelProperty
WS_HTTP_CHANNEL_BINDING. Diese
value ist ein Grenzwert für die Größe einer gestreamten Nachricht, die empfangen oder gesendet werden kann.
für den Kanal.
Der Grenzwert gibt die maximale Größe des Umschlags in Bytes an, wie er angezeigt wird.
in seiner codierten Drahtform. Der Mindestwert beträgt 1.


Diese Eigenschaft kann nur angegeben werden, wenn die gestreamte Eingabe oder Ausgabe ausgewählt wurde.
(WS_STREAMED_INPUT_TRANSFER_MODE oder WS_STREAMED_OUTPUT_TRANSFER_MODE festgelegt wurde).


Der Standardwert ist 4194304.
WS_CHANNEL_PROPERTY_MAX_STREAMED_START_SIZE
Wert: 2
Ein ULONG, der mit WsCreateChannel, WsCreateChannelForListener oder verwendet wird
WsGetChannelProperty für WS_HTTP_CHANNEL_BINDING.
Dieser Wert ist ein Grenzwert für die Größe des Anfangs einer Nachricht.
Der Anfang einer Nachricht besteht aus dem Umschlagtag, den Kopfzeilen und dem Texttag.
Der Grenzwert gibt die maximale Größe der Daten in Bytes an, wie sie in
die codierte Drahtform. Der Mindestwert beträgt 1.


Diese Eigenschaft kann nur angegeben werden, wenn gestreamte Eingabe ausgewählt wurde.
(WS_STREAMED_INPUT_TRANSFER_MODE).


Diese Eigenschaft schränkt die Menge des Arbeitsspeichers ein, den der Kanal zuweist.
um den Anfang der Nachricht zu lesen. Für die Streamingeingabe
Der gesamte Start der Nachricht wird vor der Anwendung in einen Puffer eingelesen.
wird benachrichtigt, dass der Anfang der Nachricht gelesen wurde.


Der Standardwert ist 16384.
WS_CHANNEL_PROPERTY_MAX_STREAMED_FLUSH_SIZE
Wert: 3
Ein ULONG, der mit WsCreateChannel, WsCreateChannelForListener oder verwendet wird
WsGetChannelProperty für WS_HTTP_CHANNEL_BINDING.
Dieser Wert ist ein Grenzwert für die Anzahl der Bytes, die akkumuliert werden.
bevor WsFlushBody aufgerufen wird.


Diese Eigenschaft kann nur angegeben werden, wenn die gestreamte Ausgabe ausgewählt wurde.
(WS_STREAMED_OUTPUT_TRANSFER_MODE).


Diese Eigenschaft schränkt die Menge des Arbeitsspeichers ein, den der Kanal zuweist.
um gepufferte Daten zu akkumulieren. Für die Streamingausgabe
Kanal sammelt Daten in einem Puffer, bis WsFlushBody aufgerufen wird.


Der Standardwert ist 65536.
WS_CHANNEL_PROPERTY_ENCODING
Wert: 4
Ein WS_ENCODING Wert
wird mit WsCreateChannel, WsCreateChannelForListener oder WsGetChannelProperty für WS_TCP_CHANNEL_BINDING oder WS_HTTP_CHANNEL_BINDING verwendet.
Dieser Wert gibt an, welche Codierung für den Kanal verwendet werden soll.


Der Standardwert hängt von der Bindung ab:



Die WS_UDP_CHANNEL_BINDING verwendet immer den Wert WS_ENCODING_XML_UTF8.
WS_CHANNEL_PROPERTY_ENVELOPE_VERSION
Wert: 5
Ein WS_ENVELOPE_VERSION Wert
wird mit WsCreateChannel, WsCreateChannelForListener oder WsGetChannelProperty verwendet.
Dieser Wert gibt an, welche Umschlagversion für den Kanal verwendet werden soll. The
Umschlagversion des Kanals muss mit der der Nachricht übereinstimmen, die mit verwendet wird
den Kanal.


Diese Eigenschaft wird mit dem WS_NAMEDPIPE_CHANNEL_BINDING nicht unterstützt. Named Pipe-Kanäle verwenden immer WS_ENVELOPE_VERSION_SOAP_1_2.

Der Standardwert hängt von der Bindung ab:
WS_CHANNEL_PROPERTY_ADDRESSING_VERSION
Wert: 6
Ein WS_ADDRESSING_VERSION Wert
wird mit WsCreateChannel, WsCreateChannelForListener oder WsGetChannelProperty verwendet.
Dieser Wert gibt an, welche Adressierungsversion für den Kanal verwendet werden soll. The
Adressierungsversion des Kanals muss mit der der Nachricht übereinstimmen, die mit verwendet wird.
den Kanal.


Der Standardwert hängt von der Bindung ab:



Die WS_ADDRESSING_VERSION_TRANSPORT wird nur für unterstützt.
WS_HTTP_CHANNEL_BINDING.
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE
Wert: 7
Eine ULONG, die mit WsCreateChannel, WsCreateChannelForListener oder WsGetChannelProperty verwendet wird.
Diese Eigenschaft ist nur für WS_TCP_CHANNEL_BINDING oder WS_NAMEDPIPE_CHANNEL_BINDING gültig.
Dieser Wert gibt das Kontingent für die Anzahl von Bytes des Sitzungswörterbuchs an.
Zeichenfolgen, die bei Verwendung einer sitzungsbasierten Codierung übertragen oder empfangen werden.


Die einzige sitzungsbasierte Codierung wird derzeit unterstützt.
WS_ENCODING_XML_BINARY_SESSION_1, die standardcodierung
für die WS_TCP_CHANNEL_BINDING.


Wenn das Kontingent auf der Empfangsseite erreicht wird, dann der Kanal
wird fehlerhaft.


Wenn das Kontingent aufseiten der Sendenden erreicht wird, wird der Kanal einfach
übertragen Sie die Zeichenfolge, ohne das Sitzungswörterbuch zu verwenden.


Dieser Wert wird ignoriert, wenn keine sitzungsbasierte Codierung verwendet wird.


Der Standardwert ist 2048.
WS_CHANNEL_PROPERTY_STATE
Wert: 8
Ein WS_CHANNEL_STATE-Wert
wird von WsGetChannelProperty zurückgegeben.


Der zurückgegebene Wert ist eine Momentaufnahme des aktuellen Zustands.
Möglicherweise hat sich der Zustand geändert, bevor der Aufrufer
hatte die Möglichkeit, den Wert zu untersuchen.
WS_CHANNEL_PROPERTY_ASYNC_CALLBACK_MODEL
Wert: 9
Ein WS_CALLBACK_MODEL Wert, der mit WsCreateChannel oder WsGetChannelProperty verwendet wird.
Dieser Wert gibt das bevorzugte asynchrone Rückrufmodell beim Ausgeben an.
asynchrone Vorgänge für den Kanal.


Informationen zur Verwendung von WsCreateChannelForListener finden Sie unter
WS_LISTENER_PROPERTY_ASYNC_CALLBACK_MODEL.


Der Standardwert ist WS_LONG_CALLBACK.


Sowohl die WS_SERVICE_HOST als auch die WS_SERVICE_PROXY unterstützen nur WS_LONG_CALLBACK
als zulässiger Wert für diese Eigenschaft.
WS_CHANNEL_PROPERTY_IP_VERSION
Wert: 10
Ein WS_IP_VERSION-Wert
wird mit WsCreateChannel oder WsGetChannelProperty für WS_TCP_CHANNEL_BINDING oder WS_UDP_CHANNEL_BINDING verwendet.
Diese Eigenschaft gibt an, für welche IP-Version der Kanal verwendet werden soll.
mit dem Remoteendpunkt kommunizieren.


Verwenden Sie zum Angeben der IP-Version, die für akzeptierte Kanäle verwendet werden soll.
WS_LISTENER_PROPERTY_IP_VERSION Listenereigenschaft, wenn
Das Listenerobjekt wird erstellt.


Der Standardwert ist WS_IP_VERSION_AUTO.
WS_CHANNEL_PROPERTY_RESOLVE_TIMEOUT
Wert: 11
Eine ULONG mit WsCreateChannel, WsSetChannelProperty,
oder WsSetChannelProperty für WS_HTTP_CHANNEL_BINDING und WS_CHANNEL_TYPE_REQUEST.
Dieses Timeout schränkt die Zeit ein, die für die Auflösung aufgewendet wird.
der DNS-Name. Der Timeoutwert liegt in Millisekunden,
Wobei der Wert INFINITE kein Timeout angibt.


Diese Eigenschaft kann in einem beliebigen Kanalzustand festgelegt werden.


Der Standardwert ist INFINITE.
WS_CHANNEL_PROPERTY_CONNECT_TIMEOUT
Wert: 12
Eine ULONG, die mit WsCreateChannel verwendet wird,
WsSetChannelProperty oder WsGetChannelProperty
für WS_TCP_CHANNEL_BINDING oder WS_NAMEDPIPE_CHANNEL_BINDING auf Clientseite.
Dieses Timeout begrenzt die Zeit, die zum Herstellen einer Verbindung mit dem Remotecomputer und zum Abschließen des net.tcp- oder net.pipe-Handshakes aufgewendet wird. Der Timeoutwert
liegt in Millisekunden, wobei der Wert INFINITE kein Timeout angibt. Zum Festlegen von
oder rufen Sie das entsprechende Timeout auf der Serverseite ab, verwenden Sie
(WS_LISTENER_PROPERTY_CONNECT_TIMEOUT).


Wird mit WsCreateChannel verwendet,
WsSetChannelProperty oder WsGetChannelProperty für WS_HTTP_CHANNEL_BINDING und WS_CHANNEL_TYPE_REQUEST.
Dieses Timeout schränkt die Zeit ein, die zum Herstellen einer Verbindung aufgewendet wird.
an den HTTP-Server. Der Timeoutwert liegt in Millisekunden,
Wobei der Wert INFINITE kein Timeout angibt.


Diese Eigenschaft kann in einem beliebigen Kanalzustand festgelegt werden.


Der Standardwert ist 30000 (30 Sekunden).


Der WS_SERVICE_PROXY legt dieses Timeout standardmäßig auf INFINITE fest.
WS_CHANNEL_PROPERTY_SEND_TIMEOUT
Wert: 13
Eine ULONG mitWsCreateChannel, WsCreateChannelForListener,
WsSetChannelProperty oder WsGetChannelProperty
für WS_TCP_CHANNEL_BINDING oder WS_NAMEDPIPE_CHANNEL_BINDING. Dieses Timeout schränkt die
Der Zeitraum, der für das Senden der Bytes der Nachricht aufgewendet wird.
Der Timeoutwert liegt in Millisekunden, wobei der Wert INFINITE angibt.
kein Timeout.


Wird mit WsCreateChannel, WsSetChannelProperty verwendet,
oder WsGetChannelProperty für WS_HTTP_CHANNEL_BINDING
und WS_CHANNEL_TYPE_REQUEST.
Dieses Timeout schränkt die Zeit ein, die für das Senden von
HTTP-Header und die Bytes der Nachricht. Der Timeoutwert liegt in Millisekunden, wobei
value INFINITE gibt kein Timeout an.


Diese Eigenschaft kann in einem beliebigen Kanalzustand festgelegt werden.


Der Standardwert ist 30000 (30 Sekunden).


Sowohl WS_SERVICE_HOST als auch WS_SERVICE_PROXY legen dies fest.
Timeout auf INFINITE standardmäßig.
WS_CHANNEL_PROPERTY_RECEIVE_RESPONSE_TIMEOUT
Wert: 14
Eine ULONG mit WsCreateChannel, WsSetChannelProperty,
oder WsSetChannelProperty für WS_HTTP_CHANNEL_BINDING und WS_CHANNEL_TYPE_REQUEST.
Dieses Timeout schränkt die Zeit ein, auf die gewartet wird.
alle Antwortheader, die vom Server empfangen werden sollen.
Der Timeoutwert liegt in Millisekunden, wobei der Wert INFINITE kein Timeout angibt.


Diese Eigenschaft kann in einem beliebigen Kanalzustand festgelegt werden.


Der Standardwert ist 30000 (30 Sekunden).


Das WS_SERVICE_PROXY legt dieses Timeout auf INFINITE fest.
WS_CHANNEL_PROPERTY_RECEIVE_TIMEOUT
Wert: 15
Ein ULONG , der mit WsCreateChannel, WsCreateChannelForListener verwendet wird,
WsSetChannelProperty oder WsGetChannelProperty,
für WS_TCP_CHANNEL_BINDING oder WS_NAMEDPIPE_CHANNEL_BINDING.
Dieses Timeout schränkt die Zeit ein, die für den Empfang des
die Bytes der Nachricht.
Der Timeoutwert liegt in Millisekunden, wobei der Wert INFINITE angibt.
kein Timeout.


Wird mit WsCreateChannel, WsSetChannelProperty verwendet,
oder WsGetChannelProperty für WS_HTTP_CHANNEL_BINDING und WS_CHANNEL_TYPE_REQUEST.
Dieses Timeout schränkt die Zeit ein, die für den Empfang des
Bytes der Nachricht. Der Timeoutwert liegt in Millisekunden,
wobei der Wert INFINITE kein Timeout angibt.
Dieses Timeout kann von WsWriteMessageEnd, WsReadMessageStart und WsReadMessageEnd ausgelöst werden.

Diese Eigenschaft kann in einem beliebigen Kanalzustand festgelegt werden.


Der Standardwert ist 30000 (30 Sekunden).


Sowohl WS_SERVICE_HOST als auch WS_SERVICE_PROXY festlegen
Timeout auf INFINITE standardmäßig.
WS_CHANNEL_PROPERTY_CLOSE_TIMEOUT
Wert: 16
Eine ULONG, die mit WsCreateChannel, WsCreateChannelForListener verwendet wird
WsSetChannelProperty oder WsGetChannelProperty
für WS_TCP_CHANNEL_BINDING oder WS_NAMEDPIPE_CHANNEL_BINDING.
Dieses Timeout schränkt die Zeit ein, die für das Abschließen des
schließen Sie den net.tcp- oder net.pipe-Handshake. Der Timeoutwert liegt in Millisekunden, wobei
wert INFINITE gibt kein Timeout an.


Diese Eigenschaft kann in einem beliebigen Kanalzustand festgelegt werden.


Der Standardwert ist 30000 (30 Sekunden).


Das WS_SERVICE_PROXY legt dieses Timeout standardmäßig auf INFINITE fest.
WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS
Wert: 17
Ein BOOL , der mit WsCreateChannel für WS_HTTP_CHANNEL_BINDING, WS_TCP_CHANNEL_BINDING, WS_NAMEDPIPE_CHANNEL_BINDING,
und WS_UDP_CHANNEL_BINDING.
Wird mit WsGetChannelProperty für WS_CUSTOM_CHANNEL_BINDING verwendet.


Wenn diese Eigenschaft auf TRUE festgelegt ist oder beim Aufrufen von WsCreateChannel nicht angegeben wird,
Spezifischere Kanaltimeouteigenschaften (z. B. WS_CHANNEL_PROPERTY_SEND_TIMEOUT)
hat Vorrang und verhält sich wie dokumentiert. Wenn diese Eigenschaft auf FALSE festgelegt ist,
alle spezifischen Kanaltimeouteigenschaften werden auf INFINITE festgelegt, es sei denn, sie werden explizit angegeben.


Diese Eigenschaft kann mithilfe von WsGetChannelProperty von einem benutzerdefinierten Kanal abgefragt werden.
Weitere Informationen finden Sie unter WS_GET_CHANNEL_PROPERTY_CALLBACK .


Der Standardwert ist TRUE.


Um eine eigene Timeoutlogik zu implementieren, WS_SERVICE_PROXY und
WS_SERVICE_HOST legt diese Eigenschaft für die
Standardkanalbindungen und erfordern benutzerdefinierte Kanäle, um sie durch Abfragen und
Vergewissern Sie sich, dass sie auf FALSE festgelegt ist.
Spezifischere Timeouteigenschaften können weiterhin wie oben beschrieben bereitgestellt werden.
WS_CHANNEL_PROPERTY_TRANSFER_MODE
Wert: 18
Ein WS_TRANSFER_MODE Wert
wird mit WsCreateChannel verwendet
für WS_HTTP_CHANNEL_BINDING , um zu steuern, ob Nachrichten
Gesendet und empfangen auf dem Kanal werden gepuffert oder gestreamt. Der Client
und der Server kann verschiedene Übertragungsmodi verwenden und trotzdem kommunizieren können.


Alle Kanäle unterstützen dafür WsGetChannelProperty .
Eigenschaft enthaltenen Wert.


Für andere Kanalbindungen als WS_HTTP_CHANNEL_BINDINGist der Wert immer WS_BUFFERED_TRANSFER_MODE.


Der Standardwert der Eigenschaft ist WS_BUFFERED_TRANSFER_MODE. Hinweis
nur WS_BUFFERED_TRANSFER_MODE vom Dienstmodell für beide verwendet wird
WS_SERVICE_PROXY und WS_SERVICE_HOST. Die einzige Ausnahme
ist die Verwendung von Nachrichtenverträgen auf WS_SERVICE_HOST, wobei
WS_STREAMED_OUTPUT_TRANSFER_MODE ist zulässig.



WS_STREAMED_OUTPUT_TRANSFER_MODE mit WS_CHANNEL_TYPE_REQUEST erfordert Windows Vista und höher und unterstützt nur WS_HTTP_HEADER_AUTH_SCHEME_BASIC , wenn sie mit Sicherheit verwendet werden.
WS_CHANNEL_PROPERTY_MULTICAST_INTERFACE
Wert: 19
Ein ULONG , der mit WsCreateChannel, WsSetChannelProperty verwendet wird,
oder WsGetChannelProperty für WS_UDP_CHANNEL_BINDING
mit WS_CHANNEL_TYPE_DUPLEX , um anzugeben, welcher Adapter
sollte beim Senden an eine Multicastadresse verwendet werden.


Der Wert ist der Schnittstellenindex des Adapters.


Wenn diese Eigenschaft nicht festgelegt ist oder 0 ist, dann ist der Standardadapter für die
computer wird verwendet. Dies ist möglicherweise nicht für Computer mit mehreren Adaptern geeignet.


Diese Eigenschaft kann in einem beliebigen Kanalzustand festgelegt werden.


Der Standardwert der Eigenschaft ist 0.
WS_CHANNEL_PROPERTY_MULTICAST_HOPS
Wert: 20
Eine ULONG,die mit WsCreateChannel oder WsGetChannelProperty verwendet wird
für WS_UDP_CHANNEL_BINDING mit WS_CHANNEL_TYPE_DUPLEX
, um die maximale Anzahl von Hops anzugeben, die eine UDP-Nachricht übertragen kann.


Der Standardwert der Eigenschaft ist 1.
WS_CHANNEL_PROPERTY_REMOTE_ADDRESS
Wert: 21
Eine WS_ENDPOINT_ADDRESS-Struktur
wird mit WsGetChannelProperty verwendet
für WS_UDP_CHANNEL_BINDING mit WS_CHANNEL_TYPE_DUPLEX
, um die Endpunktadresse der Remotepartei für den Kanal abzurufen.


Die Felder des zurückgegebenen
WS_ENDPOINT_ADDRESS Struktur sind gültig und konstant, bis der Kanal
wird zurückgesetzt oder freigegeben. Der Aufrufer sollte die zurückgegebenen Werte nicht ändern.
Felder des WS_ENDPOINT_ADDRESS auf zeigen.


Diese Eigenschaft kann erst abgerufen werden, wenn der Kanal den geöffneten Zustand erreicht hat.


Diese Eigenschaft basiert auf der Quell-IP-Adresse, die von empfangen wird.
das Netzwerk, das möglicherweise vorgeblich oder manipuliert wird, auch wenn ein
sicherer Kanal (abhängig von der Netzwerkumgebung).
WS_CHANNEL_PROPERTY_REMOTE_IP_ADDRESS
Wert: 22
Eine SOCKADDR_STORAGE-Struktur
verwendet mit WsCreateChannel
für die folgenden Arten von Kanälen zum Abrufen der IP-Adresse
der Remotepartei:



Diese Eigenschaft kann erst abgerufen werden, wenn der Kanal mit dem Lesen einer Nachricht begonnen hat.


Diese Eigenschaft basiert auf der Quell-IP-Adresse, die von empfangen wird.
das Netzwerk, das gespooft oder manipuliert werden kann, auch wenn ein
sicherer Kanal (abhängig von der Netzwerkumgebung).
WS_CHANNEL_PROPERTY_HTTP_CONNECTION_ID
Wert: 23
Ein Zeiger auf eine ULONGLONG,die mit WsGetChannelProperty verwendet wird
für WS_HTTP_CHANNEL_BINDING mit WS_CHANNEL_TYPE_REPLY
, um einen Bezeichner abzurufen, der die Clientverbindung eindeutig identifiziert.


Diese Eigenschaft kann erst abgerufen werden, wenn der Kanal mit dem Lesen einer Nachricht begonnen hat.


Die Verbindungs-ID identifiziert eindeutig eine Verbindung, während
Das Listenerobjekt, von dem der Kanal akzeptiert wurde, bleibt geöffnet.


Ein bestimmter Antwortkanal instance ist in keiner Weise mit einer Verbindung korreliert.
Jedes Mal, wenn der Kanal akzeptiert wird, kann eine andere Verbindungs-ID vorhanden sein.
(auch wenn sich die Gesamtzahl der Verbindungen seit der letzten Annahme nicht geändert hat).


Die Verbindungs-ID kann von einer Anwendung verwendet werden, um den Zustand mit zu korrelieren.
eine HTTP-Verbindung.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
Wert: 24
Eine WS_CUSTOM_CHANNEL_CALLBACKS-Struktur , die mit WsCreateChannel oder WsCreateChannelForListener für WS_CUSTOM_CHANNEL_BINDING verwendet wird.


Diese Eigenschaft wird verwendet, um Rückrufe anzugeben, die
definieren sie die Implementierung eines benutzerdefinierten Kanals.


Diese Eigenschaft muss angegeben werden, wenn WS_CUSTOM_CHANNEL_BINDING verwendet wird.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
Wert: 25
Ein Zeiger auf einen Datentyp beliebiger Größe, der mit WsCreateChannel oder WsCreateChannelForListener für WS_CUSTOM_CHANNEL_BINDING verwendet wird.


Diese Eigenschaft wird verwendet, um Parameter anzugeben, die zum Erstellen des benutzerdefinierten
Kanalimplementierung.


Die Größe der Eigenschaft ist die Größe des Datentyps.


Der Wert dieser Eigenschaft wird an den übergeben.
WS_CREATE_CHANNEL_CALLBACK.


Wenn diese Eigenschaft nicht angegeben wird, ist ihr Wert NULL und die Größe null.
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_INSTANCE
Wert: 26
Eine Void , die mit WsGetChannelProperty für WS_CUSTOM_CHANNEL_BINDING verwendet wird.


Die Größe der Eigenschaft ist sizeof(void
).
Der Wert entspricht dem Kanal instance Wert, der von zurückgegeben wird.
die WS_CREATE_CHANNEL_CALLBACK.


Diese Eigenschaft kann verwendet werden, um den zugrunde liegenden Kanal abzurufen.
instance für einen benutzerdefinierten Kanal. Dadurch kann ein Aufrufer direkt
Interaktion mit dem instance für Fälle, in denen die vorhandene
Der Satz von Kanaleigenschaften oder Kanalfunktionen reicht nicht aus.
WS_CHANNEL_PROPERTY_TRANSPORT_URL
Wert: 27
Eine WS_STRING-Struktur
verwendet mit WsGetChannelProperty
für WS_HTTP_CHANNEL_BINDING oder WS_TCP_CHANNEL_BINDING für Kanäle, die mit WsCreateChannelForListener erstellt wurden.


Diese Eigenschaft wird auf dem Server verwendet, um die übergebene URL abzurufen.
auf dem Client zu WsOpenChannel .
Diese URL kann sich vom Wert im WS_TO_HEADER
, wenn WsAddressMessage verwendet wurde. Die Zuordnung der
Transport-URL zum zugrunde liegenden Transport variiert je nach
WS_CHANNEL_BINDING wie folgt aus:



Diese Eigenschaft ist nur verfügbar, wenn der Kanal über
wurde mit WsAcceptChannel akzeptiert.


Der Aufrufer sollte die Adresse eines WS_STRING übergeben, wenn
Ruft diese Eigenschaft ab. Die zurückgegebene Zeichenfolge ist eine vollqualifizierte
URL in codierter Form. Die zurückgegebene Zeichenfolge ist bis zum Kanal geeignet.
wird freigegeben oder zurückgesetzt.
WS_CHANNEL_PROPERTY_NO_DELAY
Wert: 28
Ein BOOL , der mit WsCreateChannel, WsCreateChannelForListener oder WsGetChannelProperty oder WsSetChannelProperty für WS_TCP_CHANNEL_BINDING verwendet wird.


Diese Eigenschaft steuert den Wert der TCP_NODELAY Socketoption des zugrunde liegenden Sockets.


Wenn dieser Wert FALSE ist, wird der Nagle-Algorithmus verwendet, der
verbessern sie den Durchsatz, indem sie kleine Nachrichten zusammenfügen.


Wenn Sie diesen Wert auf TRUE festlegen, kann die Latenz auf Kosten des Durchsatzes verringert werden.
für kleine Nachrichten.


Der Standardwert ist FALSE.
WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES
Wert: 29
Ein BOOL , das mit WsCreateChannel, WsCreateChannelForListener für WS_TCP_CHANNEL_BINDING verwendet wird.


Diese Eigenschaft steuert den Wert der SO_KEEPALIVE Socketoption des zugrunde liegenden Sockets.


Wenn Sie diesen Wert auf TRUE festlegen, werden Keep-Alive-Pakete gesendet.
auf dem zugrunde liegenden Socket, wodurch möglicherweise erkannt werden kann, wann
eine Remotepartei ist nicht mehr verfügbar.


Der Standardwert ist FALSE.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME
Wert: 30
Eine ULONG, die mit WsCreateChannel oder WsCreateChannelForListener für WS_TCP_CHANNEL_BINDING verwendet wird.


Diese Eigenschaft wird in Millisekunden gemessen.


Diese Eigenschaft kann nur angegeben werden, wenn die eigenschaft WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES den Wert TRUE aufweist.


Der Wert stellt die Zeitspanne vor dem Senden von Keep Alive-Paketen dar, wenn
Socket wird nicht verwendet.


Der Standardwert ist 2 Stunden.
WS_CHANNEL_PROPERTY_KEEP_ALIVE_INTERVAL
Wert: 31
Eine ULONG, die mit WsCreateChannel oder WsCreateChannelForListener für WS_TCP_CHANNEL_BINDING verwendet wird.


Diese Eigenschaft wird in Millisekunden gemessen.


Diese Eigenschaft kann nur angegeben werden, wenn die eigenschaft WS_CHANNEL_PROPERTY_SEND_KEEP_ALIVES den Wert TRUE aufweist.


Nachdem die in WS_CHANNEL_PROPERTY_KEEP_ALIVE_TIME angegebene Zeit abgelaufen ist,
Das System beginnt mit dem Senden von Keep Alive-Paketen, um zu versuchen, kontaktieren
die Remotepartei. Diese Einstellung steuert, wie oft das System sendet.
ein anderes Paket (als Wiederholungsversuch).


Der Standardwert ist 1 Sekunde.
WS_CHANNEL_PROPERTY_MAX_HTTP_SERVER_CONNECTIONS
Wert: 32
Eine ULONG, die mit WsCreateChannel für WS_HTTP_CHANNEL_BINDING verwendet wird.


Diese Eigenschaft gibt die maximale Anzahl von Verbindungen an, die eine Clientanwendung aufweist.
kann für einen HTTP-Server verwendet werden.
Verbindungen können zwischengespeichert und von anderen Komponenten innerhalb desselben Prozesses wiederverwendet werden, die auf denselben HTTP-Server zugreifen.


Der Standardwert ist INFINITE (kein Limit).
WS_CHANNEL_PROPERTY_IS_SESSION_SHUT_DOWN
Wert: 33
Eine BOOL , die mit WsGetChannelProperty für WS_TCP_CHANNEL_BINDING
oder WS_NAMEDPIPE_CHANNEL_BINDING mit WS_CHANNEL_TYPE_DUPLEX_SESSION.


Diese Eigenschaft gibt an
ob WsShutdownSessionChannel
wird verwendet, um den Kanal herunterzufahren.


Der Kanal muss sich in WS_CHANNEL_STATE_OPEN oder befinden.
WS_CHANNEL_STATE_FAULTED Zustand.
WS_CHANNEL_PROPERTY_CHANNEL_TYPE
Wert: 34
Ein WS_CHANNEL_TYPE-Wert
wird mit WsGetChannelProperty für alle Kanaltypen verwendet
, um den Kanaltyp abzufragen.


Der Kanal kann sich in einem beliebigen WS_CHANNEL_STATE befinden.
WS_CHANNEL_PROPERTY_TRIM_BUFFERED_MESSAGE_SIZE
Wert: 35
Ein ULONG, der mit WsCreateChannel, WsCreateChannelForListener oder verwendet wird
WsGetChannelProperty für WS_TCP_CHANNEL_BINDING,
WS_HTTP_CHANNEL_BINDING oder WS_NAMEDPIPE_CHANNEL_BINDING , um die Speicherbelegung zu steuern
Merkmale für die Nachrichten im Kanal.


Diese Eigenschaft gibt die maximale Arbeitsspeichermenge an, die der Kanal behält.
um, nachdem eine Nachricht zurückgesetzt wurde. Wenn alle
Nachrichten, die ein Kanal sieht, sind alle kleiner als diese Größe, dann Zuordnungen
zum Puffern werden die Nachrichten minimiert.


Diese Eigenschaft kann nur angegeben werden, wenn gepufferte Eingabe oder Ausgabe
angegeben ( entweder WS_STREAMED_INPUT_TRANSFER_MODE oder
WS_STREAMED_OUTPUT_TRANSFER_MODE nicht festgelegt wurden).


Der Standardwert ist 65536.


Die WS_UDP_CHANNEL_BINDING verwendet immer den Wert 65536.
WS_CHANNEL_PROPERTY_ENCODER
Wert: 36
Eine WS_CHANNEL_ENCODER Struktur, die mit WsCreateChannel oder WsCreateChannelForListener für WS_TCP_CHANNEL_BINDING verwendet wird,
WS_HTTP_CHANNEL_BINDING oder WS_NAMEDPIPE_CHANNEL_BINDING , um eine benutzerdefinierte Codierung von Nachrichten bereitzustellen.

Diese Eigenschaft kann nicht mit WS_UDP_CHANNEL_BINDING verwendet werden.
WS_CHANNEL_PROPERTY_DECODER
Wert: 37
Eine WS_CHANNEL_DECODER-Struktur , die mit WsCreateChannel oder WsCreateChannelForListener für WS_TCP_CHANNEL_BINDING verwendet wird,
WS_HTTP_CHANNEL_BINDING oder WS_NAMEDPIPE_CHANNEL_BINDING , um eine benutzerdefinierte Dencodierung von Nachrichten bereitzustellen.

Diese Eigenschaft kann nicht mit WS_UDP_CHANNEL_BINDING verwendet werden.
WS_CHANNEL_PROPERTY_PROTECTION_LEVEL
Wert: 38
Ein WS_PROTECTION_LEVEL Wert, der mit WsGetChannelProperty für jeden Kanaltyp verwendet wird.


Diese Eigenschaft gibt an
die vom Kanal bereitgestellten Sicherheitsgarantien.


Der Wert dieser Eigenschaft hängt von den Sicherheitsanforderungen ab.
für den Kanal angefordert.
WS_CHANNEL_PROPERTY_COOKIE_MODE
Wert: 39
Ein WS_COOKIE_MODE Wert, der mit WsCreateChannel mit WS_HTTP_CHANNEL_BINDING verwendet wird, um zu steuern, wie HTTP-Cookies behandelt werden.


Der Standardwert ist WS_AUTO_COOKIE_MODE.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE
Wert: 40
Ein WS_HTTP_PROXY_SETTING_MODE Wert, der mit WsCreateChannel mit WS_HTTP_CHANNEL_BINDING verwendet wird, um die HTTP-Proxyeinstellungen für den Kanal zu steuern.


Der Standardwert ist WS_HTTP_PROXY_SETTING_MODE_AUTO.
WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY
Wert: 41
Eine WS_CUSTOM_HTTP_PROXY Struktur, die mit WsCreateChannel mit WS_HTTP_CHANNEL_BINDING verwendet wird, um die benutzerdefinierte Einstellung für den HTTP-Kanal anzugeben. Diese Eigenschaft muss
angegeben werden, wenn WS_CHANNEL_PROPERTY_HTTP_PROXY_SETTING_MODE auf festgelegt ist
WS_HTTP_PROXY_SETTING_MODE_CUSTOM.


Der Standardwert ist NULL.
WS_CHANNEL_PROPERTY_HTTP_MESSAGE_MAPPING
Wert: 42
Eine WS_HTTP_MESSAGE_MAPPING-Struktur , die mit WsCreateChannel oder WsCreateChannelForListener für WS_HTTP_CHANNEL_BINDING verwendet wird.


Dieser Eigenschaftswert steuert, wie eine HTTP-Anforderung oder -Antwort zugeordnet wird.
ein Nachrichtenobjekt. Weitere Informationen finden Sie unter WS_HTTP_MESSAGE_MAPPING .


Der Standardwert für diese Eigenschaft ist eine WS_HTTP_MESSAGE_MAPPING-Struktur wie folgt:



  • requestMappingOptions: 0

  • requestHeaderMappings: keine

  • responseMappingOptions: 0

  • responseHeaderMappings: keine



WS_HTTP_MESSAGE_MAPPING Felder requestMappingOptions und responseMappingOptions müssen 0 sein.
es sei denn, die Codierung ist mit WS_CHANNEL_PROPERTY_ENCODING der Kanaleigenschaft auf WS_ENCODING_RAW festgelegt.
WS_CHANNEL_PROPERTY_ENABLE_HTTP_REDIRECT
Wert: 43
Ein BOOL , der mit WsCreateChannel für WS_HTTP_CHANNEL_BINDING mit WS_CHANNEL_TYPE_REQUEST verwendet wird.


Dieser Eigenschaftswert steuert, ob die automatische HTTP-Umleitung aktiviert ist.


Durch Festlegen dieses Werts auf TRUE wird die automatische HTTP-Umleitung aktiviert.


Der Standardwert ist FALSE.
Wenn die WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT-Eigenschaft angegeben ist,
diese Eigenschaft wird ignoriert.
WS_CHANNEL_PROPERTY_HTTP_REDIRECT_CALLBACK_CONTEXT
Wert: 44
Eine WS_HTTP_REDIRECT_CALLBACK_CONTEXT-Struktur
wird mit WsCreateChannel für WS_HTTP_CHANNEL_BINDING mit WS_CHANNEL_TYPE_REQUEST verwendet.


Dieser Eigenschaftswert kann angegeben werden, wenn eine präzisere Steuerung der automatischen HTTP-Umleitung erforderlich ist.


Wenn diese Eigenschaft festgelegt ist, wird die angegebene Rückrufroutine mit der ursprünglichen Endpunkt-URL aufgerufen.
und die neue URL, an die die Nachricht weitergeleitet werden soll. Rückrufrückgabewert wird verwendet, um anzugeben, ob
Die Umleitung sollte zulässig sein.
WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS
Wert: 45
Ein BOOL , der mit WsCreateChannel, WsSetChannelProperty verwendet wird,
WsGetChannelProperty oder WsCreateServiceProxy für WS_HTTP_CHANNEL_BINDING und WS_CHANNEL_TYPE_REQUEST oder WS_TCP_CHANNEL_BINDING, WS_NAMEDPIPE_CHANNEL_BINDING und WS_UDP_CHANNEL_BINDING auf dem Client.


Wenn sie auf TRUE festgelegt ist, geben Kanal- und Dienstmodellfunktionen einen Fehlercode zurück, wenn ein Fehler empfangen wird.
Wenn der Fehler von dieser Runtime erkannt wird, wird der entsprechende Fehlercode zurückgegeben.
andernfalls wird WS_E_ENDPOINT_FAULT_RECEIVED zurückgegeben. (Siehe Rückgabewerte für Windows-Webdienste.) Bei Festlegung auf FALSE ist WsReceiveMessage
und WsRequestReply geben WS_E_ENDPOINT_FAULT_RECEIVED zurück, wenn ein Fehler empfangen wird.
Die anderen Kanalfunktionen geben Fehler als reguläre Nachrichten zurück und WS_MESSAGE_PROPERTY_IS_FAULT
kann verwendet werden, um Fehler von anderen Meldungen zu unterscheiden.


Wenn diese Eigenschaft auf TRUE festgelegt und mit WsCreateChannel oder WsSetChannelProperty verwendet wird,
es überschreibt das folgende Verhalten von WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS: , wenn der Fehler von erkannt wird.
Runtime: Ein ungesicherter Fehler führt nicht dazu, dass die Sicherheitsüberprüfung der Fehlermeldung fehlschlägt, auch wenn
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS ist auf FALSE festgelegt. Die status der Sicherheitsüberprüfung
kann durch Überprüfen WS_MESSAGE_PROPERTY_PROTECTION_LEVEL ermittelt werden.
Dies gilt nicht für WS_UDP_CHANNEL_BINDING , da die Sicherheit nicht unterstützt wird.


Wenn diese Eigenschaft auf FALSE festgelegt oder mit WsCreateServiceProxy verwendet wird oder der Fehler nicht erkannt wird
durch die Laufzeit gilt das in WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS beschriebene Verhalten ohne
.


Unabhängig von diesem Eigenschaftswert: Wenn ein Fehlercode als Ergebnis des Empfangens eines Fehlers zurückgegeben wird,
WsGetFaultErrorProperty kann verwendet werden, um die Details des Fehlers aus dem Fehlerobjekt abzufragen.


Diese Eigenschaft kann in einem beliebigen Kanalzustand festgelegt werden.


Der Standardwert ist TRUE. Bei Verwendung mit WsCreateServiceProxy muss diese Eigenschaft auf TRUE festgelegt werden.




Das Festlegen dieser Eigenschaft auf TRUE kann dazu führen, dass die Nachrichtensicherheitsüberprüfung für bestimmte Fehler deaktiviert wird.
Nicht überprüfte Fehler sind möglicherweise nicht vertrauenswürdig.
WS_CHANNEL_PROPERTY_ALLOW_UNSECURED_FAULTS
Wert: 46
Ein BOOL mit WsCreateChannel, WsSetChannelProperty,
oder WsGetChannelProperty für WS_HTTP_CHANNEL_BINDING und WS_CHANNEL_TYPE_REQUEST oder WS_TCP_CHANNEL_BINDING und WS_NAMEDPIPE_CHANNEL_BINDING auf dem Client.


Wenn diese Einstellung auf TRUE festgelegt ist, führen ungesicherte Fehler, die in einem sicheren Kanal empfangen werden, nicht dazu, dass die Nachrichtensicherheitsüberprüfung fehlschlägt. Stattdessen
fehler wird so behandelt, als ob die Überprüfung der Nachrichtensicherheit erfolgreich war und wie unter WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS beschrieben behandelt wird.
Die status der Sicherheitsüberprüfung kann durch Überprüfen WS_MESSAGE_PROPERTY_PROTECTION_LEVEL ermittelt werden.


Bei Festlegung auf FALSE wird die Nachrichtensicherheitsüberprüfung von Fehlermeldungen wie die Überprüfung jeder anderen Nachricht behandelt.


WS_CHANNEL_PROPERTY_FAULTS_AS_ERRORS kann diese Eigenschaft für Fehler außer Kraft setzen, die von dieser Runtime erkannt werden.


Diese Eigenschaft gilt nur für die Sicherheitsüberprüfung auf Nachrichtenebene und hat keine Auswirkungen auf die Transportsicherheit.


Diese Eigenschaft kann in einem beliebigen Kanalzustand festgelegt werden.


Der Standardwert ist FALSE.


Wenn Diese Eigenschaft auf TRUE festgelegt wird, wird die Überprüfung der Nachrichtensicherheit für Fehler deaktiviert. Ungesicherte Fehler sind möglicherweise nicht vertrauenswürdig.
WS_CHANNEL_PROPERTY_HTTP_SERVER_SPN
Wert: 47
Ein WCHAR-Zeiger
wird mit WsGetChannelProperty für WS_HTTP_CHANNEL_BINDING und WS_CHANNEL_TYPE_REQUEST verwendet.



Gibt den Serverprinzipalnamen des Remoteendpunkts zurück, der für die letzte fehlgeschlagene Anforderung verwendet wurde. Es gibt keine Garantie, dass diese Eigenschaft
verfügbar sind. Im Folgenden sind die erforderlichen (aber nicht immer ausreichenden) Bedingungen aufgeführt, damit diese Eigenschaft vorhanden ist:

  • Der Kanal hat eine Anforderung gesendet.

  • Die Anforderung ist aufgrund nicht übereinstimmender HTTP-Headerauthentifizierungsschemas fehlgeschlagen. Siehe WS_HTTP_HEADER_AUTH_SECURITY_BINDING.

  • Der Remoteendpunkt unterstützt das Authentifizierungsschema "Nego2".




Diese Eigenschaft ist nur unter Windows 7 und höher verfügbar.
WS_CHANNEL_PROPERTY_HTTP_PROXY_SPN
Wert: 48
Ein WCHAR-Zeiger , der mit WsGetChannelProperty für WS_HTTP_CHANNEL_BINDING und WS_CHANNEL_TYPE_REQUEST verwendet wird.



Gibt den Serverprinzipalnamen des HTTP-Proxyservers zurück, der für die letzte fehlgeschlagene Anforderung verwendet wurde. Es gibt keine Garantie, dass diese Eigenschaft
verfügbar sind. Im Folgenden sind die erforderlichen (aber nicht immer ausreichenden) Bedingungen aufgeführt, damit diese Eigenschaft vorhanden ist:

  • Der Kanal hat eine Anforderung gesendet.

  • Die Anforderung ist aufgrund nicht übereinstimmender HTTP-Headerauthentifizierungsschemas fehlgeschlagen. Siehe WS_HTTP_HEADER_AUTH_SECURITY_BINDING.

  • Der HTTP-Proxyserver unterstützt das Authentifizierungsschema "Nego2".




Diese Eigenschaft ist nur unter Windows 7 und höher verfügbar.
WS_CHANNEL_PROPERTY_MAX_HTTP_REQUEST_HEADERS_BUFFER_SIZE
Wert: 49
Eine ULONG, die mit WsCreateChannelForListener oder verwendet wird
WsGetChannelProperty für WS_HTTP_CHANNEL_BINDING
mit WS_CHANNEL_TYPE_REPLY. Dieser Wert ist eine Beschränkung hinsichtlich der Größe der Header.
eine EMPFANGENE HTTP-Anforderung kann sein. Der Grenzwert gibt die maximale Größe an.
der HTTP-Anforderungsheader in Bytes.


Diese Eigenschaft schränkt die Arbeitsspeichermenge ein.
dass die WS_HTTP_CHANNEL_BINDING mit WS_CHANNEL_TYPE_REPLY
wird zugeordnet, um HTTP-Anforderungsheader zu empfangen. Beim Empfang der gesamten HTTP-Anforderung
Header werden vor der Verarbeitung in einen Puffer eingelesen.


Der Standardwert ist 65536.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Kopfzeile webservices.h