Constantes d’option de liaison

Les applications définissent les constantes d’option de liaison pour contrôler la façon dont la bibliothèque Runtime RPC traite les appels de procédure distante. Le tableau suivant répertorie chaque propriété de liaison et les valeurs de constante appropriées pour les propriétés de liaison.

Notes

toutes les options de file d’attente de messages (MQ) dans le tableau suivant sont valides pour Windows 2000 uniquement. Windows XP et les versions ultérieures ne prennent pas en charge Message Queuing. Les développeurs sont déconseillés d’utiliser Message Queuing.

Constante/valeur Description
RPC _ _Liaison opt _ _ C
pour une liaison inversée
9
Par défaut. Si la valeur est false, l’ordre de causalité. Les appels RPC sont exécutés dans un ordre strict d’envoi. Consultez la section Notes.
Si la valeur est true, ordre des appels à la causalité. Les appels RPC sont exécutés indépendamment. Consultez la section Notes.
RPC _ _ _ _ Options Max opt Max
.
17
Non nécessaire pour les programmes d’application. Utilisé en interne par Microsoft.
RPC _ C _ _ ne pas réussir
4
Non nécessaire pour les programmes d’application. Utilisé en interne par Microsoft.
RPC _ C _ OPT _ session _ ID
6
Si la valeur est true, un ID de session est généré pour chaque connexion.
RPC _ C _ OPT _ cookie _ auth
7
Si la valeur est true, l’authentification basée sur les cookies côté client est utilisée pour les connexions. Un pointeur vers la structure du _ _ _ _ _ descripteur d’authentification de cookie RPC C opt est passé en tant que paramètre OptionValue dans RpcBindingSetOption.
RPC _ _UUID de _ _ type de _ ressource OPT
8
Non nécessaire pour les programmes d’application. Utilisé en interne par Microsoft.
RPC _ C _ OPT _ _
ne pas attendre
13
Si la valeur est true, forcer l’arrêt de l’Association après le dernier handle de liaison/handle de contexte sur celui-ci est libéré.
RPC _ C _ OPT _ unique _ liaison unique
11
Si la valeur est true, RPC ne réutilise pas les connexions existantes. Un handle de liaison unique est ouvert pour chaque connexion et l’État est conservé pour chaque handle de liaison unique.

Notes

Par défaut, la bibliothèque Runtime RPC exécute les appels sur un handle de liaison donné à partir de chaque thread d’une application dans un ordre strict d’envoi. Cela ne garantit pas que les appels de différents threads sur le même handle de liaison sont sérialisés. Les applications multithread doivent sérialiser leurs appels RPC. Si ce comportement est trop restrictif, vous pouvez activer le classement non-causalité. Dans ce cas, la bibliothèque Runtime RPC exécute les appels indépendamment. Il n’impose aucun ordre d’envoi.

Un exemple d’application susceptible de trouver un ordre non-causalité utile est un programme multithread dont les threads effectuent des appels sur le même handle de liaison. De même, un programme qui utilise plusieurs appels asynchrones sur un handle de liaison trouvera une option pratique qui est pratique. Un autre exemple peut être un programme de proxy Internet qui utilise un thread unique pour gérer les demandes de plusieurs clients. Dans chacun de ces cas, il serait extrêmement restrictif d’essayer de sérialiser les appels de procédure distante.

L’option de non- _ acceptation RPC C _ OPT _ _ ne peut être définie que sur des handles de liaison qui utilisent les séquences de protocole Ncalrpc ou *ncacn _ * _. Elle ne peut pas être utilisée sur les séquences de protocole ncadg _ * . La fonction _ RpcBindingSetOption * avec cette option doit être appelée sur un handle de liaison sur lequel au moins un appel RPC a été effectué. Si aucun appel RPC n’a été effectué sur le handle de liaison, le _ _ _ type _ de _ liaison RPC S incorrect est retourné à partir de l’appel de fonction RpcBindingSetOption . L’option prend effet pour l’ensemble de l’Association, quel que soit le nombre de descripteurs de liaisons attachés à l’Association. Étant donné qu’elle est vérifiée avant la destruction de l’Association, elle peut être définie à tout moment avant la fermeture du handle de liaison.

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 ;
Rpcdcep. h

Voir aussi

RpcBindingSetOption

RpcBindingInqOption

Gestion des groupes de connexions réseau (associations)