Extract_Conversation_Security_User_ID (CPI-C)
La chiamata Extract_Conversation_Security_User_ID (nome funzione cmecsu) restituisce l'identificatore utente usato in una conversazione specificata.
Sintassi
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
);
Parametri
conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation o Accept_Conversation.
security_user_ID
Parametro restituito. Specifica l'identificatore utente usato per stabilire la conversazione.
security_user_ID_length
Parametro restituito. Specifica la lunghezza di security_user_ID.
return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.
Codici restituiti
CM_OK
Codice restituito primario; la chiamata eseguita correttamente.
CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; il valore specificato da conversation_ID non è valido.
Modifiche di stato
La conversazione può essere in qualsiasi stato tranne RESET.
Non esiste alcuna modifica dello stato.
Commenti
Il valore security_user_ID non viene riempito con spazi. È significativo solo per security_user_ID_length.