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.