Set_Conversation_Security_Password (CPI-C)

  • Article

L’appel Set_Conversation_Security_Password (nom de fonction cmscsp) est émis par le programme appelant pour spécifier le mot de passe requis pour accéder au programme appelé.

Syntaxe

  
CM_ENTRY Set_Conversation_Security_Password(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *security_password,    
  CM_INT32 FAR *security_password_length,    
  CM_INT32 FAR *return_code              
);

Paramètres

conversation_ID
Paramètre fourni. Spécifie l’identificateur de la conversation. La valeur de ce paramètre a été retournée par Initialize_Conversation.

security_password
Paramètre fourni. Spécifie le mot de passe requis pour accéder au programme partenaire. Ce paramètre est une chaîne de caractères de huit caractères ASCII maximum et respecte la casse. Il doit correspondre au mot de passe de l’identificateur d’utilisateur configuré pour le programme partenaire.

Les caractères autorisés sont les suivants :

  • Majuscules et minuscules.

  • Nombres de 0 à 9.

  • Caractères spéciaux, à l’exception de l’espace.

    Si la fonctionnalité d’ouverture de session automatique CPI-C doit être utilisée, ce paramètre doit être défini sur la chaîne MS$SAME. Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.

    security_password_length
    Paramètre fourni. Spécifie la longueur de security_password. La plage est comprise entre 0 et 8.

    Si la fonctionnalité d’ouverture de session automatique CPI-C doit être utilisée, ce paramètre doit avoir la valeur 7. Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.

    return_code
    Code retourné par cet appel. Les codes de retour valides sont répertoriés plus loin dans cette rubrique.

Codes de retour

CM_OK
Code de retour principal ; l’appel a été exécuté avec succès.

CM_PROGRAM_PARAMETER_CHECK
Code de retour principal ; l’un des événements suivants s’est produit :

  • La valeur spécifiée par conversation_ID n’est pas valide.

  • La valeur spécifiée par security_password_length est hors de portée.

    CM_PROGRAM_STATE_CHECK
    Code de retour principal ; l’un des événements suivants s’est produit :

  • La conversation n’est pas dans l’état INITIALIZE.

  • Le type de sécurité des conversations n’est pas défini sur CM_SECURITY_PROGRAM.

Changements d'état

La conversation doit être à l’état INITIALIZE.

Il n’y a aucun changement d’état.

Remarques

Cet appel n’a d’effet sur la conversation que si le type de sécurité de la conversation est CM_SECURITY_PROGRAM ou CM_SECURITY_SAME. Il remplace le mot de passe initial à partir des informations latérales spécifiées par Initialize_Conversation. Cet appel ne peut pas être émis après l’émission d’Allocation .

Un mot de passe non valide n’est pas détecté tant que la demande d’allocation, générée par Allocation, n’est pas envoyée à l’unité logique partenaire (LU). L’erreur est retournée au programme d’appel lors d’un appel suivant.

L’ouverture de session automatique pour les applications CPI-C est prise en charge par Host Integration Server. Cette fonctionnalité nécessite une configuration spécifique de la part de l’administrateur réseau : l’application CPI-C doit être appelée côté RÉSEAU à partir d’un client du serveur SNA. Le client doit être connecté à un domaine Microsoft Windows, mais peut être n’importe quelle plateforme prenant en charge les API CPI-C host Integration Server.

L’application cliente est codée pour utiliser la sécurité au niveau du programme, avec un nom d’utilisateur CPI-C codé en dur spécial MS$SAME et un mot de passe MS$SAME. Lorsque cette allocation de session passe du client au serveur SNA, le serveur SNA recherche le compte d’hôte et le mot de passe correspondant au compte Windows sous lequel le client est connecté, et remplace les informations du compte hôte dans le message d’attachement APPC qu’il envoie à l’hôte.