Extract_Conversation_Security_Type (CPI-C)

L’appel Extract_Conversation_Security_Type (nom de fonction xcecst) retourne le type de sécurité pour une conversation spécifiée.

Syntaxe

  
CM_ENTRY Extract_Conversation_Security_Type(   
  unsigned char FAR *conversation_ID,          
    CM_INT32 FAR *conversation_security_type,    
    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 ou Accept_Conversation.

conversation_security_type
Paramètre retourné. Spécifie les informations requises par l’unité logique partenaire pour valider l’accès au programme appelé. Les valeurs possibles sont les suivantes :

CM_SECURITY_NONE
Le programme appelé n’utilise aucune sécurité de conversation.

CM_SECURITY_PROGRAM
Le programme appelé utilise la sécurité de conversation et requiert donc un identificateur d’utilisateur et un mot de passe.

CM_SECURITY_SAME
Le programme appelé, appelé avec un identificateur d’utilisateur et un mot de passe valides, appelle à son tour un autre programme (comme l’illustre la communication entre les TPS). Par exemple, supposons que le programme A appelle le programme B avec un identificateur d’utilisateur et un mot de passe valides, et que le programme B appelle à son tour le programme C. Si le programme B spécifie la valeur CM_SECURITY_SAME, CPI-C envoie le LU pour le programme C, l’identificateur d’utilisateur à partir du programme A et un indicateur déjà vérifié. Cet indicateur indique au programme C de ne pas exiger le mot de passe (si le programme C est configuré pour accepter un indicateur déjà vérifié).

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 ; la valeur spécifiée par conversation_ID n’est pas valide ou l’adresse d’une variable n’est pas valide.

Changements d'état

La conversation peut être dans n’importe quel État, à l’exception de RESET.

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