Extract_Conversation_Security_User_ID (CPI-C)

La llamada Extract_Conversation_Security_User_ID (nombre de función cmecsu) devuelve el identificador de usuario que se usa en una conversación especificada.

Sintaxis

  
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              
);  

Parámetros

conversation_ID
Parámetro proporcionado. Especifica el identificador de la conversación. El valor de este parámetro lo devolvió Initialize_Conversation o Accept_Conversation.

security_user_ID
Parámetro devuelto. Especifica el identificador de usuario que se usó para establecer la conversación.

security_user_ID_length
Parámetro devuelto. Especifica la longitud de security_user_ID.

return_code
Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente.

CM_PROGRAM_PARAMETER_CHECK
Código de retorno principal; el valor especificado por conversation_ID no es válido.

Cambios de estado

La conversación puede estar en cualquier estado excepto RESET.

No hay ningún cambio de estado.

Comentarios

El valor de security_user_ID no se rellena con espacios. Solo es significativo hasta security_user_ID_length.