Extract_Conversation_Security_Type (CPI-C)

  • [アーティクル]

Extract_Conversation_Security_Type呼び出し (関数名 xcecst) は、指定された会話のセキュリティの種類を返します。

構文

  
CM_ENTRY Extract_Conversation_Security_Type(   
  unsigned char FAR *conversation_ID,          
    CM_INT32 FAR *conversation_security_type,    
    CM_INT32 FAR *return_code                    
);

パラメーター

conversation_ID
指定されたパラメーター。 会話の識別子を指定します。 このパラメーターの値は 、Initialize_Conversation または Accept_Conversationによって返されました。

conversation_security_type
返されたパラメーター。 呼び出されたプログラムへのアクセスを検証するためにパートナー論理装置 (LU) が必要とする情報を指定します。 次のいずれかの値になります。

CM_SECURITY_NONE
呼び出されたプログラムは、会話セキュリティを使用しません。

CM_SECURITY_PROGRAM
呼び出されたプログラムは会話セキュリティを使用するため、ユーザー識別子とパスワードが必要です。

CM_SECURITY_SAME
呼び出されたプログラムは、有効なユーザー ID とパスワードを使用して呼び出され、別のプログラムを呼び出します (「 TP 間の通信」に示すように)。 たとえば、プログラム A が有効なユーザー識別子とパスワードを使用してプログラム B を呼び出し、プログラム B がプログラム C を呼び出すとします。プログラム B がCM_SECURITY_SAME値を指定した場合、CPI-C はプログラム C の LU、プログラム A からのユーザー ID、および既に検証済みの標識を送信します。 このインジケーターは、プログラム C にパスワードを必要としないように指示します (プログラム C が既に検証済みのインジケーターを受け入れるように構成されている場合)。

return_code
この呼び出しから返されたコード。 有効なリターン コードについては、このトピックの後半で説明します。

リターン コード

CM_OK
主なリターン コード。呼び出しが正常に実行されました。

CM_PROGRAM_PARAMETER_CHECK
主なリターン コード。 conversation_ID で指定された値が無効であるか、変数のアドレスが無効です。

State Changes (状態の変化)

会話は RESET 以外の任意の状態にすることができます。

状態の変更はありません。