Set_Conversation_Security_User_ID呼び出し (関数名 cmscsu) は、呼び出されたプログラムへのアクセスを取得するために必要なユーザー ID を指定するために、呼び出し側プログラムによって発行されます。
構文
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
指定されたパラメーター。 パートナー プログラムにアクセスするために必要なユーザー識別子を指定します。 このパラメーターは、最大 8 文字の 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によって指定されたサイド情報から、初期ユーザー識別子がオーバーライドされます。 Allocate が発行された後、この呼び出しを発行することはできません。
Allocate によって生成された割り当て要求がパートナー論理ユニット (LU) に送信されるまで、無効なユーザー識別子は検出されません。 このエラーは、後続の呼び出しで呼び出し元のプログラムに返されます。
CPI-C アプリケーションの自動ログオンは、Host Integration Server でサポートされています。 この機能には、ネットワーク管理者による特定の構成が必要です。 CPI-C アプリケーションは、SNA サーバーのクライアントから LAN 側で呼び出す必要があります。 クライアントは Microsoft Windows Server ドメインにログインする必要がありますが、SNA Server CPI-C API をサポートする任意のプラットフォームにすることができます。
クライアント アプリケーションは、プログラム レベルのセキュリティを使用するようにコーディングされ、特殊なハードコーディングされた CPI-C ユーザー名 MS$SAME とパスワード MS$SAME が使用されます。 このセッション割り当てがクライアントから SNA サーバーに送信されると、SNA サーバーは、クライアントがログオンしている Windows Server アカウントに対応するホスト アカウントとパスワードを検索し、ホスト アカウント情報をホストに送信する APPC 添付メッセージに置き換えます。