Set_Conversation_Security_User_ID (CPI-C)

  • 發行項

叫用程式發出 Set_Conversation_Security_User_ID 呼叫 (函式名稱 cmscsu) ，以指定取得所叫用程式存取權所需的使用者識別碼。

語法

  
CM_ENTRY Set_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傳回。

security_user_ID
提供的參數。 指定取得合作夥伴計畫存取權所需的使用者識別碼。 此參數是最多八個 ASCII 字元的字元字串，且區分大小寫。

允許的字元為：

  • 大寫和小寫字母。

  • 數位從 0 到 9。

  • 特殊字元，但空格除外。

    如果要使用 CPI-C 自動登入功能，此參數必須設定為 MS$SAME 字串。 如需詳細資訊，請參閱本主題稍後的一節。

    security_user_ID_length
    提供的參數。 指定 security_user_ID的長度。 範圍是從 0 到 8。

    如果要使用 CPI-C 自動登入功能，此參數必須設定為 7。 如需詳細資訊，請參閱本主題稍後的一節。

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

傳回碼

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

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項：

  • conversation_ID指定的值無效。

  • security_user_ID_length指定的值超出範圍。

    CM_PROGRAM_STATE_CHECK
    主要傳回碼;發生下列其中一項：

  • 交談不是處於 INITIALIZE 狀態。

  • 交談安全性類型未設定為 CM_SECURITY_PROGRAM。

    CM_PRODUCT_SPECIFIC_ERROR
    主要傳回碼;發生產品特定的錯誤，並已記錄在產品錯誤記錄檔中。

狀態變更

交談必須處於 INITIALIZE 狀態。

沒有狀態變更。

備註

只有在交談安全性類型CM_SECURITY_PROGRAM或CM_SECURITY_SAME時，此呼叫才會對交談產生影響。 它會從 Initialize_Conversation所指定的側邊資訊覆寫初始使用者識別碼。 在發出 [配置 ] 之後，無法發出此呼叫。

在 配置所產生的配置要求傳送給夥伴邏輯單元 (LU) 之前，不會偵測到不正確使用者識別碼。 錯誤會在後續呼叫時傳回至叫用程式。

主機整合伺服器支援 CPI-C 應用程式的自動登入。 這項功能需要網路系統管理員的特定設定。 必須從 SNA 伺服器的用戶端在 LAN 端叫用 CPI-C 應用程式。 用戶端必須登入 Microsoft Windows Server 網域，但可以是任何支援 SNA 伺服器 CPI-C API 的平臺。

用戶端應用程式會編碼為使用程式層級安全性，並具有特殊的硬式編碼 CPI-C 使用者名稱 MS$SAME 和密碼 MS$SAME。 當此會話配置從用戶端流向 SNA 伺服器時，SNA 伺服器會查閱對應至用戶端登入所在 Windows Server 帳戶的主機帳戶和密碼，並將主機帳戶資訊取代為它傳送至主機的 APPC 附加訊息。