RPC_POLICY structure (rpcdce.h)
La structure RPC_POLICY contient des indicateurs qui déterminent la liaison sur les ordinateurs multi-hébergements et les allocations de ports lors de l’utilisation des protocoles ncacn_ip_tcp et ncadg_ip_udp .
Syntaxe
typedef struct _RPC_POLICY {
unsigned int Length;
unsigned long EndpointFlags;
unsigned long NICFlags;
} RPC_POLICY, *PRPC_POLICY;
Membres
Length
Taille de la structure RPC_POLICY , en octets. Le membre Length permet la compatibilité avec les futures versions de cette structure, qui peuvent contenir des champs supplémentaires. Définissez toujours la longueur égale à sizeof(RPC_POLICY) lorsque vous initialisez la structure RPC_POLICY dans votre code.
EndpointFlags
Ensemble d’indicateurs qui déterminent les attributs du ou des ports où le serveur reçoit des appels de procédure distante. Vous pouvez spécifier plusieurs indicateurs (à l’aide de l’opérateur OR au niveau du bit) à partir du jeu de valeurs pour une séquence de protocole donnée. Le tableau suivant répertorie les valeurs possibles pour le membre EndpointFlags .
| Valeur | Signification |
|---|---|
|
Spécifie la valeur par défaut du système. |
|
Alloue le point de terminaison à partir de l’un des ports définis dans le Registre comme « Internet disponible ». Valide uniquement avec les séquences de protocole ncacn_ip_tcp et ncadg_ip_udp . |
|
Alloue le point de terminaison à partir de l’un des ports définis dans le Registre comme « Intranet disponible ». Valide uniquement avec les séquences de protocole ncacn_ip_tcp et ncadg_ip_udp . |
|
La file d’attente processus-réception du serveur est automatiquement supprimée lorsque le serveur RPC se ferme. Tous les appels en attente toujours dans la file d’attente seront perdus. Il s’agit de la valeur par défaut. Valide uniquement avec la séquence de protocole ncadg_mq . |
|
Spécifie que la file d’attente processus-réception du serveur persiste après la fermeture du processus serveur. La valeur par défaut est que la file d’attente est supprimée à l’arrêt du processus serveur. Valide uniquement avec ncadg_mq séquence de protocole. |
|
Si la file d’attente de réception existe déjà parce qu’elle a été ouverte précédemment en tant que file d’attente permanente, effacez tous les appels en attente dans la file d’attente. Valide uniquement avec la séquence de protocole ncadg_mq uniquement. |
|
Si la file d’attente de réception existe déjà, ne modifiez pas ses paramètres existants pour l’authentification ou le chiffrement. Valide uniquement avec la séquence de protocole ncadg_mq. |
|
La file d’attente processus-réception du serveur accepte uniquement les appels authentifiés des clients. Par défaut, les appels authentifiés et non authentifiés sont acceptés. Valide uniquement avec ncadg_mq séquence de protocole. |
|
Les appels au serveur sont chiffrés. La valeur par défaut est que les appels chiffrés et non chiffrés sont acceptés. Valide uniquement avec ncadg_mq séquence de protocole. |
|
La file d’attente de réception du serveur accepte tous les appels des clients. Il s’agit du niveau d’authentification par défaut. Valide uniquement avec le protocole ncadg_mq . |
|
Définit la file d’attente de réception du serveur pour accepter uniquement les appels clients ayant un niveau d’authentification RPC_C_AUTHN_LEVEL_PKT_INTEGRITY ou RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Valide uniquement avec la séquence de protocole ncadg_mq. |
|
Définit la file d’attente de réception du serveur pour accepter uniquement les appels clients ayant un niveau d’authentification RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Les appels avec un niveau d’authentification inférieur sont ignorés. Valide uniquement avec la séquence de protocole ncadg_mq. |
Note Si le Registre ne contient aucune des clés qui spécifient les stratégies par défaut, le membre EndpointFlags n’aura aucun effet au moment de l’exécution. Si une clé est manquante ou contient une valeur non valide, toute la configuration de ce protocole ( ncacn_ip_tcp, ncadg_ip_udp ou ncadg_mq) est marquée comme non valide et tous les appels aux fonctions RpcServerUseProtseq* sur ce protocole échouent.
NICFlags
Stratégie de liaison à des cartes d’interface réseau. Le tableau suivant répertorie les valeurs possibles pour le membre NICFlags .
| Valeur | Signification |
|---|---|
|
Lie aux cartes réseau sur la base des paramètres du Registre. Utilisez toujours cette valeur lorsque vous utilisez la structure RPC_POLICY pour définir les propriétés de file d’attente de messages. |
|
Remplace les paramètres du Registre et lie à toutes les cartes réseau. Si la clé de liaison est manquante dans le Registre, le membre NICFlags n’aura aucun effet au moment de l’exécution. Si la clé contient une valeur non valide, toute la configuration est marquée comme non valide et tous les appels à RpcServerUseProtseq* échouent. |
Remarques
Vous pouvez utiliser la structure RPC_Policy pour définir des stratégies pour les appels de procédure distante au moment de l’exécution. Ces stratégies sont les suivantes :
- Mise en file d’attente des messages : permet au serveur de spécifier les propriétés de message-file d’attente, telles que la sécurité, la qualité de remise et la durée de vie de la file d’attente de processus serveur. Cette stratégie est uniquement efficace pour les appels distants via le transport de file d’attente de message (ncadg_mq).
- Allocation de ports pour les ports dynamiques : spécifie si le point de terminaison inscrit par cette application doit accéder à l’ensemble de ports disponibles sur Internet ou intranet.
- Liaison sélective : permet aux machines multi-hébergements de se lier de manière sélective aux cartes réseau.
Note L’allocation de ports et les stratégies de liaison sélective sont efficaces uniquement pour les appels distants via des connexions TCP ( ncacn_ip_tcp) et UDP ( ncadg_ip_udp). Pour plus d’informations, consultez Configuration du Registre pour les allocations de ports et la liaison sélective.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | rpcdce.h (inclure Rpc.h) |
Voir aussi
Configuration du Registre pour les allocations de ports et la liaison sélective