Condividi tramite


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.