Extract_Conversation_Security_User_ID （CPI-C）

Extract_Conversation_Security_User_ID呼叫 （函 式 名稱 cmecsu） 會傳回指定交談中使用的使用者識別碼。

語法

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

參數

conversation_ID
提供的參數。 指定交談的標識碼。 此參數的值是由 Initialize_Conversation 或 Accept_Conversation 所傳回。

security_user_ID
傳回的參數。 指定用來建立交談的使用者標識碼。

security_user_ID_length
傳回的參數。 指定 security_user_ID長度。

return_code
從這個呼叫傳回的程序代碼。 本主題稍後會列出有效的傳回碼。

回傳代碼

CM_OK
主要傳回碼;已成功執行的呼叫。

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼; conversation_ID 指定的值無效。

狀態變更

交談可以是 RESET 以外的任何狀態。

沒有狀態變更。

備註

security_user_ID值未填補空格。 只有 security_user_ID_length才有意義。