énumération WS_SERVICE_ENDPOINT_PROPERTY_ID (webservices.h)
Chaque propriété représente des paramètres facultatifs pour la configuration de la structure WS_SERVICE_ENDPOINT donnée. Cette énumération est utilisée dans la structure WS_SERVICE_ENDPOINT_PROPERTY qui fait partie de WS_SERVICE_ENDPOINT.
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;
Constantes
WS_SERVICE_ENDPOINT_PROPERTY_ACCEPT_CHANNEL_CALLBACKValeur : 0 Utilisé avec WS_SERVICE_ENDPOINT. La valeur est un pointeur vers WS_SERVICE_PROPERTY_ACCEPT_CALLBACK structure. |
WS_SERVICE_ENDPOINT_PROPERTY_CLOSE_CHANNEL_CALLBACKValeur : 1 Utilisé avec WS_SERVICE_ENDPOINT. La valeur est un pointeur vers WS_SERVICE_PROPERTY_CLOSE_CALLBACK structure. |
WS_SERVICE_ENDPOINT_PROPERTY_MAX_ACCEPTING_CHANNELSValeur : 2 Utilisé avec WS_SERVICE_ENDPOINT, cela spécifie le nombre maximal de canaux simultanés que l’hôte de service aura accepter activement de nouvelles connexions pour un point de terminaison donné. Quand elle n’est pas spécifiée, cette valeur est définie sur 1. Si un point de terminaison spécifie un gestionnaire de messages par défaut (voir WS_SERVICE_ENDPOINT) doit être 1. |
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCYValeur : 3 Utilisé avec WS_SERVICE_ENDPOINT, il spécifie le nombre maximal d’appels simultanés qui seraient traités sur un canal basé sur une session. Quand elle n’est pas spécifiée, cette valeur est définie sur 1. Si un point de terminaison spécifie un gestionnaire de messages par défaut (voir WS_SERVICE_ENDPOINT accès concurrentiel doit être 1. |
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_MAX_SIZEValeur : 4 Taille maximale du tas pour la désérialisation du corps. Il s’agit du paramètre de tas disponible utilisé pour désérialiser le corps. Ce tas est également disponible pour les opérations de service pour l’allocation de paramètres. La valeur par défaut est 65535 octets. |
WS_SERVICE_ENDPOINT_PROPERTY_BODY_HEAP_TRIM_SIZEValeur : 5 Taille de coupe de tas pour la désérialisation du corps. Il s’agit du paramètre de tas disponible utilisé pour désérialiser le corps. Ce tas est également disponible pour les opérations de service pour l’allocation de paramètres. La valeur par défaut est 4 096 octets. |
WS_SERVICE_ENDPOINT_PROPERTY_MESSAGE_PROPERTIESValeur : 6 Cette propriété permet à l’utilisateur de spécifier les propriétés du message objets utilisés par le point de terminaison pour envoyer et recevoir des messages. Cette propriété peut être spécifiée lors de la création de l’hôte 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_SERVICE_ENDPOINT_PROPERTY_MAX_CALL_POOL_SIZEValeur : 7 Nombre maximal d’objets de maintenance d’appel qui seraient mis en pool pour traiter un objet de message, sur un objet donné Terminaison. Notez qu’en cas de canaux basés sur la session, de nombreux objets d’appel peuvent être utilisés sur un seul canal si WS_SERVICE_ENDPOINT_PROPERTY_MAX_CONCURRENCY est supérieur à 1. Pour les canaux sans session, cette propriété doit idéalement être égale à WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZE. La valeur par défaut est 100. |
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNEL_POOL_SIZEValeur : 8 Nombre maximal de WS_CHANNEL qui seront regroupées par hôte de service sur un élément donné Terminaison. La valeur par défaut est 100. |
WS_SERVICE_ENDPOINT_PROPERTY_LISTENER_PROPERTIESValeur : 9 Propriétés de l’écouteur. |
WS_SERVICE_ENDPOINT_PROPERTY_CHECK_MUST_UNDERSTANDValeur : 10 Active ou désactive doit comprendre la vérification d’en-tête sur un point de terminaison. Il s’agit de « TRUE » par défaut. |
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPEValeur : 11 Cette propriété peut être définie sur WS_METADATA_EXCHANGE_TYPE_MEX pour activer maintenance des requêtes WS-MetadataExchange sur le point de terminaison. Si l’application souhaite exposer des métadonnées via HTTP GET, cette propriété peut être définie sur WS_METADATA_EXCHANGE_TYPE_HTTP_GET Si elle n’est pas spécifiée, la valeur par défaut de cette propriété est « WS_METADATA_EXCHANGE_TYPE_NONE ». Notez que cette propriété lorsqu’elle est définie sur WS_METADATA_EXCHANGE_TYPE_HTTP_GET modifie la propriété WS_LISTENER WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS et WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS à WS_MATCH_URL_PREFIX_PATH. Lorsque vous définissez cette propriété sur WS_METADATA_EXCHANGE_TYPE_HTTP_GET une application ne doit pas spécifier WS_MATCH_URL_EXACT_PATH pour l’écouteur WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS et WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS pour le WS_SERVICE_ENDPOINT donné. |
WS_SERVICE_ENDPOINT_PROPERTY_METADATAValeur : 12 Spécifie le nom de port WSDL, le nom de liaison et l’espace de noms de liaison pour le point de terminaison. Cette propriété doit être spécifiée pour permettre la participation du WS_SERVICE_ENDPOINT dans WS-Metadata Exchange. Pour plus d’informations, consultez WS_SERVICE_ENDPOINT_METADATA . |
WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_URL_SUFFIXValeur : 13 Spécifie le suffixe qui est concaténé tel qu’à l’URL de WS_SERVICE_ENDPOINT pour générer une URL pour la maintenance des requêtes WS-MetadataExchange v1.1. L’URL générée est utilisée pour comparer l’en-tête « à » du message reçu. Notez que si le message ne contient pas d’en-tête « à », les demandes ne sont pas Serviced. Cette propriété ne doit être spécifiée que si WS_SERVICE_ENDPOINT_PROPERTY_METADATA_EXCHANGE_TYPE a la valeur WS_METADATA_EXCHANGE_TYPE_MEX. La spécification de cette propriété est utile dans les cas où une application souhaite gérer WS-Transfer demandes Get et utiliser le même point de terminaison à service WS-MetadataExchange demandes v1.1. Dans ce cas, l’URL de génération est utilisée pour filtrer WS-Transfer obtenir des demandes pour Ws-MetadataExchange v1.1. Par défaut, aucun filtrage n’est effectué pour WS-MetadataExchange v1.1 pour MEX et toutes les requêtes GET WS-Transfer sont gérées par le point de terminaison pour Ws-MetadataExchange v1.1, si Ws-MetadataExchange v1.1 est activé sur le point de terminaison. Notez que cette propriété modifie la WS_LISTENERpropriété WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS et WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS à WS_MATCH_URL_PREFIX_PATH. Lors de la définition de cette propriété, une application ne doit pas spécifier WS_MATCH_URL_EXACT_PATH pour l’écouteur WS_LISTENER_PROPERTY_TRANSPORT_URL_MATCHING_OPTIONS et WS_LISTENER_PROPERTY_TO_HEADER_MATCHING_OPTIONS pour le WS_SERVICE_ENDPOINT donné. |
WS_SERVICE_ENDPOINT_PROPERTY_MAX_CHANNELSValeur : 14 Nombre maximal de canaux pouvant être mis en service sur le point de terminaison. La valeur par défaut est 100. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| En-tête | webservices.h |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour