Set_Conversation_Security_Password (CPI-C)

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 allant jusqu’à huit caractères ASCII et respecte la casse. Il doit correspondre au mot de passe de l’identificateur utilisateur configuré pour le programme partenaire.

Les caractères autorisés sont les suivants :

• Majuscules et minuscules.

• Chiffres 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 être défini sur 7. Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.

  return_code
  Code retourné à partir de 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’une des opérations suivantes s’est produite :

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

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

  CM_PROGRAM_STATE_CHECK
  Code de retour principal ; l’une des opérations suivantes s’est produite :

• 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.

Modifications d’état

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

Il n’y a aucune modification d’état.

Remarques

Cet appel a un effet sur la conversation uniquement si le type de sécurité de conversation est CM_SECURITY_PROGRAM ou CM_SECURITY_SAME. Il remplace le mot de passe initial des informations latérales spécifiées par Initialize_Conversation. Cet appel ne peut pas être émis une fois l’allocation émise.

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

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 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 il peut s’agir de n’importe quelle plateforme prenant en charge les API Host Integration Server CPI-C.

L’application cliente est codée pour utiliser la sécurité au niveau du programme, avec un nom d’utilisateur spécial CPI-C nom d’utilisateur MS$SAME et mot de passe MS$SAME. Lorsque cette allocation de session passe du client au serveur SNA, le serveur SNA recherche le compte 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.