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才有意義。