次の方法で共有

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
指定されたパラメーター。 パートナー プログラムにアクセスするために必要なパスワードを指定します。 このパラメーターは、最大 8 文字の ASCII 文字の文字列であり、大文字と小文字が区別されます。 これは、パートナー・プログラム用に構成されたユーザー ID のパスワードと一致している必要があります。

使用できる文字は次のとおりです。

  • 大文字と小文字。

  • 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 に設定されていません。

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 ドメインにログインする必要がありますが、Host Integration Server CPI-C API をサポートする任意のプラットフォームにすることができます。

クライアント アプリケーションは、プログラム レベルのセキュリティを使用するようにコーディングされ、特別なハードコーディングされた CPI-C ユーザー名 MS$SAME とパスワード MS$SAME が使用されます。 このセッション割り当てがクライアントから SNA Server に送信されると、SNA サーバーは、クライアントがログインしている Windows アカウントに対応するホスト アカウントとパスワードを検索し、ホスト アカウント情報をホストに送信する APPC アタッチ メッセージに置き換えます。