Set_Conversation_Security_User_ID (CPI-C)

  • [アーティクル]

呼び出し元のプログラムによって 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
    主なリターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。

State Changes (状態の変化)

会話は 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 アタッチ メッセージにホスト アカウント情報を置き換えます。