Condividi tramite

enumerazione WS_SERVICE_ENDPOINT_PROPERTY_ID (webservices.h)

  • Articolo

Ogni proprietà rappresenta parametri facoltativi per la configurazione della struttura di WS_SERVICE_ENDPOINT specificata. Questa enumerazione viene utilizzata all'interno della struttura WS_SERVICE_ENDPOINT_PROPERTY che fa parte di WS_SERVICE_ENDPOINT.

Sintassi

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;

Costanti

 
WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACK
Valore: 0
Usato con WS_SERVICE_ENDPOINT.
Il valore è un puntatore alla struttura WS_SERVICE_PROPERTY_ACCEPT_CALLBACK.
WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACK
Valore: 1
Usato con WS_SERVICE_ENDPOINT.
Il valore è un puntatore alla struttura WS_SERVICE_PROPERTY_CLOSE_CALLBACK.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELS
Valore: 2
Usato con WS_SERVICE_ENDPOINT, specifica il numero massimo di host del servizio canali simultanei
accettare attivamente nuove connessioni per un determinato endpoint. Se non specificato, questo valore è impostato su 1. Se un endpoint specifica un gestore di messaggi predefinito (vedere WS_SERVICE_ENDPOINT) concorrenza
deve essere 1.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY
Valore: 3
Usato con WS_SERVICE_ENDPOINT, specifica il numero massimo di chiamate simultanee che verrebbero gestite in un canale basato su sessione.
Se non specificato, questo valore è impostato su 1. Se un endpoint specifica un gestore di messaggi predefinito (vedere WS_SERVICE_ENDPOINT concorrenza
deve essere 1.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZE
Valore: 4
Dimensioni massime dell'heap per la deserializzazione del corpo.


Questa è l'impostazione disponibile dell'heap usata per deserializzare il corpo. Questo heap è anche
disponibile per le operazioni del servizio per l'allocazione dei parametri.


Il valore predefinito è 65535 byte.
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZE
Valore: 5
Dimensioni di taglio dell'heap per la deserializzazione del corpo.


Questa è l'impostazione disponibile dell'heap usata per deserializzare il corpo. Questo heap è anche
disponibile per le operazioni del servizio per l'allocazione dei parametri.


Il valore predefinito è 4096 byte.
WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIES
Valore: 6
Questa proprietà consente all'utente di specificare le proprietà del messaggio
oggetti utilizzati dall'endpoint per inviare e ricevere messaggi.


Questa proprietà può essere specificata quando viene creato l'host del servizio.


Il valore specificato deve essere di tipo WS_MESSAGE_PROPERTIES.


È possibile specificare le proprietà del messaggio seguenti:
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZE
Valore: 7
Numero massimo di oggetti di manutenzione delle chiamate in pool per il servizio di un oggetto messaggio, in un determinato oggetto
Endpoint. Si noti che, in caso di canali basati su sessione, molti oggetti chiamata possono essere usati su un singolo oggetto
canale se WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY è maggiore di 1.


Per i canali senza sessione questa proprietà deve essere idealmente uguale a WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE.


Il valore predefinito è 100.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE
Valore: 8
Numero massimo di WS_CHANNEL che verranno inseriti in pool dall'host del servizio in un determinato
Endpoint.


Il valore predefinito è 100.
WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIES
Valore: 9
Proprietà del listener.
WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTAND
Valore: 10
Abilita o disabilita la verifica dell'intestazione in un endpoint. Questa opzione è "TRUE" per impostazione predefinita.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE
Valore: 11
Questa proprietà può essere impostata su WS_METADATA_EXCHANGE_TYPE_MEX per abilitare
manutenzione delle richieste di WS-MetadataExchange nell'endpoint. Nel caso in cui l'applicazione desideri
esporre i metadati tramite HTTP GET, questa proprietà può essere impostata su WS_METADATA_EXCHANGE_TYPE_HTTP_GET

Se non specificato, il valore predefinito di questa proprietà è 'WS_METADATA_EXCHANGE_TYPE_NONE'.


Si noti che questa proprietà quando è impostata su WS_METADATA_EXCHANGE_TYPE_HTTP_GET modifica la proprietà WS_LISTENER
WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS e
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS a WS_MATCH_URL_PREFIX_PATH.


Quando si imposta questa proprietà su WS_METADATA_EXCHANGE_TYPE_HTTP_GET un'applicazione non deve specificare WS_MATCH_URL_EXACT_PATH per il listener
proprietà WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS e WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS per il WS_SERVICE_ENDPOINT specificato.
WS_SERVICE_ENDPOINT_PROPERTY_METADATA
Valore: 12
Specifica il nome della porta WSDL, il nome dell'associazione e lo spazio dei nomi di associazione per l'endpoint.


Questa proprietà deve essere specificata per consentire la partecipazione del WS_SERVICE_ENDPOINT in WS-Metadata Exchange.


Per altri dettagli, vedere WS_SERVICE_ENDPOINT_METADATA .
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIX
Valore: 13
Specifica il suffisso concatenato così com'è all'URL WS_SERVICE_ENDPOINT per generare un URL per WS-MetadataExchange v1.1 per la manutenzione delle richieste.
L'URL generato viene usato per confrontare l'intestazione "a" del messaggio ricevuto. Si noti che se il messaggio non contiene un'intestazione "to" le richieste non sono
Serviced.


Questa proprietà deve essere specificata solo se WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE è impostato su WS_METADATA_EXCHANGE_TYPE_MEX.


Specificare questa proprietà è utile nei casi in cui un'applicazione desidera gestire WS-Transfer Ottenere richieste e usare lo stesso endpoint per il servizio
WS-MetadataExchange richieste v1.1. L'URL generato in questo caso viene usato per filtrare WS-Transfer Ottenere richieste per Ws-MetadataExchange v1.1.


Per impostazione predefinita, non viene eseguito alcun filtro per WS-MetadataExchange v1.1 per MEX e tutte le richieste GET WS-Transfer verranno gestite dall'endpoint per Ws-MetadataExchange v1.1, se
Ws-MetadataExchange v1.1 è abilitato nell'endpoint.


Si noti che questa proprietà modifica la proprietà WS_LISTENER WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS e
WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS a WS_MATCH_URL_PREFIX_PATH.


Quando si imposta questa proprietà, un'applicazione non deve specificare WS_MATCH_URL_EXACT_PATH per il listener
proprietà WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS e WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS
per il WS_SERVICE_ENDPOINT specificato.
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELS
Valore: 14
Numero massimo di canali che possono essere gestiti nell'endpoint.


Il valore predefinito è 100.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Intestazione webservices.h