Condividi tramite

enumerazione WS_PROXY_PROPERTY_ID (webservices.h)

  • Articolo

Parametri facoltativi per la configurazione del proxy del servizio. Ad eccezione di WS_PROXY_PROPERTY_STATE tutti i valori sono supportati solo per l'uso con WsCreateServiceProxy come parte del parametro WS_PROXY_PROPERTY* .

Sintassi

typedef enum {
  WS_PROXY_PROPERTY_CALL_TIMEOUT = 0,
  WS_PROXY_PROPERTY_MESSAGE_PROPERTIES = 1,
  WS_PROXY_PROPERTY_MAX_CALL_POOL_SIZE = 2,
  WS_PROXY_PROPERTY_STATE = 3,
  WS_PROXY_PROPERTY_MAX_PENDING_CALLS = 4,
  WS_PROXY_PROPERTY_MAX_CLOSE_TIMEOUT = 5,
  WS_PROXY_FAULT_LANG_ID = 6
} WS_PROXY_PROPERTY_ID;

Costanti

 
WS_PROXY_PROPERTY_CALL_TIMEOUT
Valore: 0
Quantità massima di tempo in millisecondi per la quale una chiamata rimane in sospeso.
Il valore predefinito è 30000 millisecondi(30 secondi). È di tipo ULONG.

Se un'applicazione vuole non avere alcun timeout associato a una chiamata, può impostare il valore su INFINITE.


Questa proprietà è di sola scrittura.
WS_PROXY_PROPERTY_MESSAGE_PROPERTIES
Valore: 1
Questa proprietà consente all'utente di specificare le proprietà del messaggio
oggetti utilizzati dal proxy del servizio per inviare e ricevere messaggi.


Questa proprietà può essere specificata quando viene creato il proxy del servizio.


Il valore specificato deve essere di tipo WS_MESSAGE_PROPERTIES.


È possibile specificare le proprietà del messaggio seguenti:
WS_PROXY_PROPERTY_MAX_CALL_POOL_SIZE
Valore: 2
Ogni chiamata nel proxy del servizio è rappresentata da un oggetto interno al proxy del servizio.
Un oggetto chiamata è progettato in modo che, dopo ogni chiamata, possa essere riutilizzato.
Ciò consente alle applicazioni di aumentare le prestazioni negli scenari previsti
numero elevato di chiamate tramite il proxy del servizio. Il valore predefinito per questa proprietà è 5.
È di tipo USHORT.

Questa proprietà è di sola scrittura.
WS_PROXY_PROPERTY_STATE
Valore: 3
Stato corrente del proxy del servizio.
È di tipo WS_SERVICE_PROXY_STATE.

Questa proprietà è di sola lettura.


Il valore restituito è uno snapshot dello stato corrente, quindi è
possibile che lo stato sia cambiato prima che il chiamante abbia
aveva la possibilità di esaminare il valore.
WS_PROXY_PROPERTY_MAX_PENDING_CALLS
Valore: 4
Numero massimo di chiamate in sospeso consentite nel proxy del servizio. Se il parametro
numero massimo di chiamate in sospeso nel proxy del servizio raggiunge questo limite,
le chiamate in arrivo verranno rifiutate con WS_E_QUOTA_EXCEEDED (vedere Valori restituiti di Servizi Web Windows). il valore predefinito
per questa proprietà è 100.
È di tipo ULONG.

Questa proprietà è di sola scrittura.
WS_PROXY_PROPERTY_MAX_CLOSE_TIMEOUT
Valore: 5
La quantità di tempo in millisecondi che il proxy del servizio attenderà il completamento delle chiamate in sospeso.
Una volta scaduto il timeout, il proxy del servizio interromperà se stesso.


Il valore predefinito per questa proprietà è 5000 (5 secondi).


Questa proprietà è di sola scrittura.
È di tipo ULONG.
WS_PROXY_FAULT_LANG_ID
Valore: 6
LANGID che verrebbe usato per restituire un errore. Se non verranno utilizzate impostazioni locali utente predefinite non specificate. È di tipo LANGID.


Questa proprietà è di sola scrittura.

Requisiti

   
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Windows Server 2008 R2 [app desktop | App UWP]
Intestazione webservices.h