RPC_POLICY structure (rpcdce.h)

Article
03/01/2024

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
0	Spécifie la valeur par défaut du système.
RPC_C_USE_INTERNET_PORT	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 .
RPC_C_USE_INTRANET_PORT	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 .
RPC_C_MQ_TEMPORARY	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 .
RPC_C_MQ_PERMANENT	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.
RPC_C_MQ_CLEAR_ON_OPEN	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.
RPC_C_MQ_USE_EXISTING_SECURITY	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.
RPC_C_MQ_AUTHENTICATE	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.
RPC_C_MQ_ENCRYPT	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.
RPC_C_MQ_AUTHN_LEVEL_NONE	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 .
RPC_C_MQ_AUTHN_LEVEL_PKT_INTEGRITY	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.
RPC_C_MQ_AUTHN_LEVEL_PKT_PRIVACY	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
0	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.
RPC_C_BIND_TO_ALL_NICS	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)