Extract_Conversation_Security_User_ID (CPI-C)

L’appel Extract_Conversation_Security_User_ID (nom de fonction cmecsu) retourne l’identificateur utilisateur utilisé dans une conversation spécifiée.

Syntaxe

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

security_user_ID
Paramètre retourné. Spécifie l’identificateur d’utilisateur utilisé pour établir la conversation.

security_user_ID_length
Paramètre retourné. Spécifie la longueur de security_user_ID.

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 ; la valeur spécifiée par conversation_ID 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.

Remarques

La valeur security_user_ID n’est pas remplie d’espaces. Elle n’a de sens que jusqu’à security_user_ID_length.