Set_Conversation_Security_Password (CPI-C)
叫用程式發出 Set_Conversation_Security_Password呼叫 (函式名稱 cmscsp) ,以指定取得叫用程式存取權所需的密碼。
語法
CM_ENTRY Set_Conversation_Security_Password(
unsigned char FAR *conversation_ID,
unsigned char FAR *security_password,
CM_INT32 FAR *security_password_length,
CM_INT32 FAR *return_code
);
參數
conversation_ID
提供的參數。 指定交談的識別碼。 這個參數的值是由 Initialize_Conversation傳回。
security_password
提供的參數。 指定取得合作夥伴計畫存取權所需的密碼。 此參數是最多八個 ASCII 字元的字元字串,且區分大小寫。 它必須符合為合作夥伴計畫設定的使用者識別碼密碼。
允許的字元為:
大寫和小寫字母。
數位從 0 到 9。
特殊字元,但空格除外。
如果要使用 CPI-C 自動登入功能,此參數必須設定為 MS$SAME 字串。 如需詳細資訊,請參閱本主題稍後的一節。
security_password_length
提供的參數。 指定 security_password長度。 範圍是從 0 到 8。如果要使用 CPI-C 自動登入功能,此參數必須設定為 7。 如需詳細資訊,請參閱本主題稍後的一節。
return_code
從這個呼叫傳回的程式碼。 本主題稍後會列出有效的傳回碼。
傳回碼
CM_OK
主要傳回碼;已成功執行呼叫。
CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項:
conversation_ID指定的值無效。
security_password_length指定的值超出範圍。
CM_PROGRAM_STATE_CHECK
主要傳回碼;發生下列其中一項:交談不是處於 INITIALIZE 狀態。
交談安全性類型未設定為 CM_SECURITY_PROGRAM。
狀態變更
交談必須處於 INITIALIZE 狀態。
沒有狀態變更。
備註
只有在交談安全性類型CM_SECURITY_PROGRAM或CM_SECURITY_SAME時,此呼叫才會對交談產生影響。 它會覆寫 Initialize_Conversation所指定側邊資訊的初始密碼。 在發出 [配置 ] 之後,無法發出此呼叫。
在 配置所產生的配置要求傳送至夥伴邏輯單元 (LU) 之前,不會偵測到不正確密碼。 錯誤會在後續呼叫時傳回至叫用程式。
主機整合伺服器支援 CPI-C 應用程式的自動登入。 這項功能需要網路系統管理員的特定設定:必須從 SNA 伺服器的用戶端在 LAN 端叫用 CPI-C 應用程式。 用戶端必須登入 Microsoft Windows 網域,但可以是任何支援主機整合伺服器 CPI-C API 的平臺。
用戶端應用程式會編碼為使用程式層級安全性,並具有特殊的硬式編碼 CPI-C 使用者名稱 MS$SAME 和密碼 MS$SAME。 當此會話配置從用戶端流向 SNA 伺服器時,SNA 伺服器會查閱對應至用戶端登入所在 Windows 帳戶的主機帳戶和密碼,並將主機帳戶資訊取代為它傳送給主機的 APPC 附加訊息。