Entrées de Registre pour les clients (CPI-C)
La liste suivante fournit des détails sur les entrées de Registre pour les ordinateurs clients. Pour chaque type de programme transactionnel (TP), les variables applicables et leurs emplacements sont affichés dans Configuration des clients pour prendre en charge les programmes de prise en charge (CPI-C).
OtherDependencies :REG_MULTI_SZ :SnaBase
Pour un TP exécuté en tant que service, vérifie que le service SnaBase est démarré avant le démarrage du TP. Cette entrée appartient sous la sous-clé Liaison .
SNAServiceType :REG_DWORD :{ 0x5 | 0x6 | 0x1A }
Indique le type de TP. Utilisez la valeur 0x5 pour un TP en file d’attente démarré automatiquement, 0x6 pour un TP sans file d’attente démarré automatiquement et 0x1A pour un TP démarré par l’opérateur.
Notez que la valeur d’un TP démarré automatiquement s’exécutant en tant que service doit être 0x5, car ces programmes sont toujours mis en file d’attente, comme décrit dans Invokable TPs.
Chemin:REG_EXPAND_SZ : chemin d’accès
Pour un TP démarré automatiquement s’exécutant en tant qu’application, spécifie le chemin d’accès et le nom de fichier du TP. Le type de données de REG_EXPAND_SZ signifie que le chemin d’accès peut contenir une chaîne de données extensible. Par exemple, %SystemRoot% représente le répertoire contenant les fichiers système Windows. Notez que pour un TP exécuté en tant que service, une entrée équivalente est insérée par l’appel CreateService . Aucune entrée de chemin supplémentaire n’est nécessaire.
LocalLU :REG_SZ : LUalias
Spécifie l’alias de l’unité logique locale à utiliser lorsque ce TP est démarré sur cet ordinateur.
Paramètres:REG_SZ : ParameterList
Répertorie les paramètres à utiliser par le TP. Séparez les paramètres par des espaces.
Timeout:REG_DWORD : nombre
Spécifie la durée, en millisecondes, pendant laquelle un Accept_Conversation attend avant d’expirer. Spécifiez le nombre en nombre décimal. L’éditeur du Registre le convertit en hexadécimal avant de l’afficher. La valeur par défaut est l’infini (aucune limite).
AcceptNames :REG_SZ : TPNameList
Répertorie les noms supplémentaires sous lesquels le TP invocable peut être appelé. Séparez les noms TP par des espaces. La valeur par défaut est aucune gestion. Si un tp invocable n’émet pas de Specify_Local_TP_Name pour chaque nom configuré sous AcceptNames dans le Registre, ce TP échoue.
ConversationSecurity :REG_SZ :{ OUI | NO }
Indique si ce TP prend en charge la sécurité des conversations. La valeur par défaut est NO.
Déjà vérifié :REG_SZ :{ OUI | NO }
Indique si ce TP peut être appelé avec un identificateur d’utilisateur et un mot de passe qui ont déjà été vérifiés. AlreadyVerified est ignoré si ConversationSecurity est défini sur NO.
Pour obtenir un diagramme de trois TPs dans une conversation, où le troisième TP peut être appelé avec un mot de passe déjà vérifié par le deuxième TP, consultez Communication between TPs. Le tableau suivant indique les conditions requises pour l’utilisation de la vérification de mot de passe dans une chaîne de TPs.
| First TP (un TP d’appel) | Second TP (tp invokable qui confirme le mot de passe, puis appelle un autre TP) | Troisième et autres TPs (appels qui appellent d’autres TPs) |
|---|---|---|
| N’a pas besoin de variables de Registre ou d’environnement. | Le paramètre ConversationSecurity doit être OUI. | Le paramètre ConversationSecurity doit être OUI. |
| N’a pas besoin de variables de Registre ou d’environnement. | Le paramètre AlreadyVerified peut être OUI ou NON. | Le paramètre AlreadyVerified doit être OUI. |
| Nom ou Set_Conversation_ de destination symbolique Security_Type dans ce TP spécifie PROGRAM pour le type de sécurité. Par conséquent, le TP transmet l’identificateur d’utilisateur et le mot de passe fournis dans le nom de destination symbolique (ou par le biais d’appels (1)). |
Nom ou Set_Conversation_ de destination symbolique Security_Type dans ce TP spécifie SAME pour le type de sécurité. Par conséquent, après avoir confirmé l’identificateur d’utilisateur et le mot de passe, le TP transmet l’identificateur d’utilisateur et un indicateur déjà vérifié. |
Nom ou Set_Conversation_ de destination symbolique Security_Type dans ce TP spécifie SAME pour le type de sécurité. Par conséquent, le TP transmet l’identificateur d’utilisateur tel qu’il a été reçu, ainsi que l’indicateur déjà vérifié. |
Notes
Set_Conversation_Security_User_ID ou Set_Conversation_Security_Password remplace l’identificateur d’utilisateur et le mot de passe spécifiés dans le nom de destination symbolique.
Notes
Si vous définissez AlreadyVerified sur NON, ce tp ne peut pas se joindre à une chaîne de conversations où la vérification du mot de passe est déjà effectuée. (L’exception à cela est lorsque ConversationSecurity est défini sur NON, auquel cas le TP peut être le tp final dans une telle chaîne, car il n’effectue aucune vérification.)
Notes
Si vous configurez un tp qui doit parfois confirmer un mot de passe et accepte parfois un indicateur déjà vérifié, définissez AlreadyVerified sur OUI et configurez la variable UsernameX de manière appropriée. Dans ce cas, chaque fois que le TP est appelé sans l’indicateur déjà vérifié, AlreadyVerified est ignoré. La vérification est tentée avec l’identificateur d’utilisateur et le mot de passe configurés pour le TP.
Notes
La valeur par défaut de AlreadyVerified est NO. Si vous définissez AlreadyVerified sur OUI, assurez-vous que ConversationSecurity est également défini sur OUI.
Nom d’utilisateur1 :REG_SZ : Mot de passe1... UsernameX :REG_SZ : PasswordX
Définit un ou plusieurs noms d’utilisateur et mots de passe à comparer à ceux envoyés par le tp appelant. Le nom d’utilisateur et le mot de passe peuvent chacun compter 10 caractères. Les deux paramètres respectent la casse.
Cette variable est ignorée si la sécurité de la conversation n’est pas activée ou si le mot de passe a déjà été vérifié, comme décrit pour l’entrée Déjà vérifié.