WS_SERVICE_ENDPOINT_PROPERTY_ID-Enumeration (webservices.h)

  • Artikel

Jede Eigenschaft stellt optionale Parameter zum Konfigurieren der angegebenen WS_SERVICE_ENDPOINT-Struktur dar. Diese Enumeration wird in der WS_SERVICE_ENDPOINT_PROPERTY-Struktur verwendet, die Teil von WS_SERVICE_ENDPOINT ist.

Syntax

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;

Konstanten

 
WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK
Wert: 0
Wird mit WS_SERVICE_ENDPOINT verwendet.
Der Wert ist ein Zeiger auf WS_SERVICE_PROPERTY_ACCEPT_CALLBACK Struktur.
WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK
Wert: 1
Wird mit WS_SERVICE_ENDPOINT verwendet.
Der Wert ist ein Zeiger auf WS_SERVICE_PROPERTY_CLOSE_CALLBACK Struktur.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS
Wert: 2
Dies gibt die maximale Anzahl gleichzeitiger Kanäle des Diensthosts an, die mit WS_SERVICE_ENDPOINT verwendet wird.
aktives Akzeptieren neuer Verbindungen für einen bestimmten Endpunkt. Wenn dieser Wert nicht angegeben ist, wird dieser Wert auf 1 festgelegt. Wenn ein Endpunkt einen Standardnachrichtenhandler angibt (siehe WS_SERVICE_ENDPOINT) Parallelität
muss 1 sein.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY
Wert: 3
Dies wird mit WS_SERVICE_ENDPOINT verwendet und gibt die maximale Anzahl gleichzeitiger Aufrufe an, die in einem sitzungsbasierten Kanal gewartet werden.
Wenn dieser Wert nicht angegeben ist, wird dieser Wert auf 1 festgelegt. Wenn ein Endpunkt einen Standardnachrichtenhandler angibt (siehe WS_SERVICE_ENDPOINT Parallelität
muss 1 sein.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE
Wert: 4
Maximale Heapgröße für die Deserialisierung des Texts.


Dies ist die verfügbare Heapeinstellung, die zum Deserialisieren des Texts verwendet wird. Dieser Heap ist auch
verfügbar für Dienstvorgänge zum Zuweisen von Parametern.


Der Standardwert ist 65535 Bytes.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE
Wert: 5
Heap trim size for body deserialization.


Dies ist die verfügbare Heapeinstellung, die zum Deserialisieren des Texts verwendet wird. Dieser Heap ist auch
verfügbar für Dienstvorgänge zum Zuweisen von Parametern.


Der Standardwert ist 4096 Bytes.
WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES
Wert: 6
Mit dieser Eigenschaft kann der Benutzer Eigenschaften der Nachricht angeben.
-Objekte, die vom Endpunkt zum Senden und Empfangen von Nachrichten verwendet werden.


Diese Eigenschaft kann beim Erstellen des Diensthosts angegeben werden.


Der angegebene Wert sollte vom Typ WS_MESSAGE_PROPERTIES sein.


Die folgenden Nachrichteneigenschaften können angegeben werden:
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE
Wert: 7
Die maximale Anzahl von Aufrufwartungsobjekten, die für den Dienst eines Nachrichtenobjekts in einem Pool zusammengefasst werden würden
Endpunkt. Beachten Sie, dass bei sitzungsbasierten Kanälen viele Aufrufobjekte auf einer einzelnen Seite verwendet werden können.
Kanal, wenn WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY größer als 1 ist.


Für sitzungslose Kanäle sollte diese Eigenschaft im Idealfall gleich WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE sein.


Der Standardwert ist 100.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE
Wert: 8
Die maximale Anzahl von WS_CHANNEL , die vom Diensthost in einem bestimmten Pool zusammengefasst werden.
Endpunkt.


Der Standardwert ist 100.
WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES
Wert: 9
Listenereigenschaften.
WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND
Wert: 10
Aktivieren oder Deaktivieren müssen die Headerüberprüfung auf einem Endpunkt verstehen. Dies ist standardmäßig "TRUE".
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE
Wert: 11
Diese Eigenschaft kann auf WS_METADATA_EXCHANGE_TYPE_MEX festgelegt werden, um zu aktivieren
Wartung von WS-MetadataExchange Anforderungen auf dem Endpunkt. Falls die Anwendung dies wünscht
Metadaten über HTTP GET verfügbar machen, kann diese Eigenschaft auf WS_METADATA_EXCHANGE_TYPE_HTTP_GET

Falls nicht angegeben, lautet der Standardwert dieser Eigenschaft "WS_METADATA_EXCHANGE_TYPE_NONE".


Beachten Sie, dass diese Eigenschaft, wenn sie auf WS_METADATA_EXCHANGE_TYPE_HTTP_GET festgelegt ist, die eigenschaft WS_LISTENER ändert
WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS und
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS auf WS_MATCH_URL_PREFIX_PATH.


Beim Festlegen dieser Eigenschaft auf WS_METADATA_EXCHANGE_TYPE_HTTP_GET darf eine Anwendung keine WS_MATCH_URL_EXACT_PATH für den Listener angeben.
Eigenschaften WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS und WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS für die angegebene WS_SERVICE_ENDPOINT.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA
Wert: 12
Gibt den WSDL-Portnamen, den Bindungsnamen und den Bindungsnamespace für den Endpunkt an.


Diese Eigenschaft muss angegeben werden, um die Teilnahme des WS_SERVICE_ENDPOINT an WS-Metadata Exchange zu ermöglichen.


Weitere Informationen finden Sie unter WS_SERVICE_ENDPOINT_METADATA .
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX
Wert: 13
Gibt das Suffix an, das mit der WS_SERVICE_ENDPOINT-URL verkettet ist, um eine URL für WS-MetadataExchange v1.1-Anforderungen zu generieren.
Die generierte URL wird verwendet, um mit dem "to"-Header der empfangenen Nachricht zu vergleichen. Beachten Sie, dass die Anforderungen nicht vorhanden sind, wenn die Nachricht keinen "to"-Header enthält.
Serviced.


Diese Eigenschaft darf nur angegeben werden, wenn WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE auf WS_METADATA_EXCHANGE_TYPE_MEX festgelegt ist.


Das Angeben dieser Eigenschaft ist nützlich, wenn eine Anwendung WS-Transfer Get-Anforderungen verarbeiten und denselben Endpunkt für den Dienst verwenden möchte.
WS-MetadataExchange v1.1-Anforderungen. Die Generieren-URL wird in diesem Fall verwendet, um WS-Transfer Abrufen von Anforderungen für Ws-MetadataExchange v1.1 herauszufiltern.


Standardmäßig wird keine Filterung für WS-MetadataExchange v1.1 für MEX durchgeführt, und alle WS-Transfer GET-Anforderungen werden vom Endpunkt für Ws-MetadataExchange v1.1 verarbeitet, wenn
Ws-MetadataExchange v1.1 ist auf dem Endpunkt aktiviert.


Beachten Sie, dass diese Eigenschaft die WS_LISTENER Eigenschaft WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS und ändert.
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS auf WS_MATCH_URL_PREFIX_PATH.


Beim Festlegen dieser Eigenschaft darf eine Anwendung keine WS_MATCH_URL_EXACT_PATH für den Listener angeben.
Eigenschaften WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS und WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS
für die angegebene WS_SERVICE_ENDPOINT.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS
Wert: 14
Die maximale Anzahl von Kanälen, die auf dem Endpunkt bedient werden können.


Der Standardwert ist 100.

Anforderungen

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