Partager via

énumération WS_PROXY_PROPERTY_ID (webservices.h)

  • Article

Paramètres facultatifs pour la configuration du proxy de service. À l’exception de WS_PROXY_PROPERTY_STATE toutes les valeurs sont uniquement prises en charge pour une utilisation avec WsCreateServiceProxy dans le cadre du paramètre WS_PROXY_PROPERTY* .

Syntax

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;

Constantes

 
WS_PROXY_PROPERTY_CALL_TIMEOUT
Valeur : 0
Durée maximale, en millisecondes, pendant laquelle un appel reste en attente.
La valeur par défaut est de 30 000 millisecondes (30 secondes). Il est de type ULONG.

Si une application souhaite n’avoir aucun délai d’attente associé à un appel, elle peut définir la valeur sur INFINITE.


Cette propriété est en écriture uniquement.
WS_PROXY_PROPERTY_MESSAGE_PROPERTIES
Valeur : 1
Cette propriété permet à l’utilisateur de spécifier les propriétés du message
objets utilisés par le proxy de service pour envoyer et recevoir des messages.


Cette propriété peut être spécifiée lors de la création du proxy de service.


La valeur spécifiée doit être de type WS_MESSAGE_PROPERTIES.


Les propriétés de message suivantes peuvent être spécifiées :
WS_PROXY_PROPERTY_MAX_CALL_POOL_SIZE
Valeur : 2
Chaque appel dans le proxy de service est représenté par un objet interne au proxy de service.
Un objet d’appel est conçu de telle sorte qu’après chaque appel, il puisse être réutilisé.
Cela permet aux applications de mieux mettre à l’échelle dans les scénarios où elles s’attendent
grand nombre d’appels sur le proxy de service. La valeur par défaut de cette propriété est 5.
Il est de type USHORT.

Cette propriété est en écriture uniquement.
WS_PROXY_PROPERTY_STATE
Valeur : 3
État actuel du proxy de service.
Il est de type WS_SERVICE_PROXY_STATE.

Cette propriété est en lecture seule.


La valeur retournée est une instantané de l’état actuel.
possible que l’état ait changé avant que l’appelant ait
a eu l’occasion d’examiner la valeur.
WS_PROXY_PROPERTY_MAX_PENDING_CALLS
Valeur : 4
Nombre maximal d’appels en attente autorisés sur le proxy de service. Si la
le nombre maximal d’appels en attente sur le proxy de service atteint cette limite.
les appels entrants seront rejetés avec WS_E_QUOTA_EXCEEDED (voir Valeurs de retour des services Web Windows). Valeur par défaut
car cette propriété est 100.
Il est de type ULONG.

Cette propriété est en écriture uniquement.
WS_PROXY_PROPERTY_MAX_CLOSE_TIMEOUT
Valeur : 5
Durée en millisecondes pendant laquelle le proxy de service attend la fin des appels en attente.
Une fois le délai d’expiration expiré, le proxy de service s’interrompt lui-même.


La valeur par défaut de cette propriété est 5000 (5 secondes).


Cette propriété est en écriture uniquement.
Il est de type ULONG.
WS_PROXY_FAULT_LANG_ID
Valeur : 6
LANGID qui serait utilisé pour retourner une erreur. Si aucun paramètre régional d’utilisateur par défaut n’est spécifié, il sera utilisé. Il est de type LANGID.


Cette propriété est en écriture uniquement.

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
En-tête webservices.h