Extract_Conversation_Security_Type (CPI-C)

  • 發行項

Extract_Conversation_Security_Type呼叫 (函數名稱xcecst) 會傳回指定交談的安全性類型。

語法

  
CM_ENTRY Extract_Conversation_Security_Type(   
  unsigned char FAR *conversation_ID,          
    CM_INT32 FAR *conversation_security_type,    
    CM_INT32 FAR *return_code                    
);

參數

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

conversation_security_type
傳回的參數。 指定夥伴邏輯單元 (LU) 需要驗證叫用程式的存取權的資訊。 可能的值包括：

CM_SECURITY_NONE
叫用的程式不會使用交談安全性。

CM_SECURITY_PROGRAM
叫用的程式會使用交談安全性，因此需要使用者識別碼和密碼。

CM_SECURITY_SAME
叫用的程式會使用有效的使用者識別碼和密碼叫用，接著會叫用另一個程式 (，如 TP 之間的通訊) 所示。 例如，假設程式 A 會叫用具有有效使用者識別碼和密碼的程式 B，而程式 B 接著會叫用程式 C。如果程式 B 指定值CM_SECURITY_SAME，CPI-C 會傳送程式 C 的 LU、來自程式 A 的使用者識別碼，以及已驗證的指標。 如果程式 C 設定為接受已驗證的指標) ，此指標會告知程式 C 不需要密碼 (。

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

傳回碼

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

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼; conversation_ID 指定的值無效，或變數的位址無效。

狀態變更

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

沒有狀態變更。