次の方法で共有

IcomLUO.CreateSession メソッド

  • [アーティクル]

新しい LU0 セッションを作成します。

構文

  
void CreateSession(  
   string connectionSTR,  
   short initType,  
   ref System.Array data,  
   int timeout,  
   out object sessionHandle  
)

パラメーター

パラメーター 説明
connectionSTR 新しいセッションの接続プロパティを示す NULL で終わる文字列。 文字列は、スペースで区切られた形式の "PROPERTY=VALUE" で表示されます。 接続プロパティの名前と値では、大文字と小文字が区別されません。 接続プロパティの詳細については、「IcomLUO セッションのプロパティ」を参照してください。
initType セッション初期化の種類を含みます。 詳細については、「コメント」を参照してください。
data INITSELF または SSCP ログオン メッセージを含む unsigned char 型の配列をポインターします。 INIT_INITSELFまたはINIT_LOGONが含まれている場合 initType にのみ使用されます。
timeout BIND コマンドと SDT コマンドが到着するまで待機する時間 (ミリ秒単位)。 SDT が到着する前にタイムアウトが切れると、SNA サーバー LU が解放され、エラーが返されます。

にtimeout入力すると0xfffffff、無限の待機時間が示されます。
sessionHandle このメソッドが正常に返されると、 には、基になる LU0 セッションを表す comLU0 セッション オブジェクトへの IUnknown インターフェイスへのポインターが含まれます。 参照がこのインターフェイスに保持されるのと同様に、セッション オブジェクトはそのまま残ります。

このインターフェイスは、セッションを使用して comLU0 オブジェクトに接続するために、IcomLU0.Connect メソッドに渡すことができます。

LU プロパティが指定されていない場合、comLU0 は、実行しているユーザー アカウントに割り当てられている使用可能な最適な LU を選択します。

戻り値

次の表では、CreateSession のリターン コードについて説明します。

値 説明
S_OK LU0 セッションが正常に作成されました。 LU セッションはアクティブであり、入力を受け取る準備ができています。
CLU0_S_SSCP_ACTIVE LU0 セッションが正常に作成されました。 SSCP セッションはアクティブであり、入力を受信する準備ができています。

このリターン コードは、 が にINIT_SSCP設定されている場合initTypeにのみ有効です。
CLU0_E_NEG_RESPONSE ホストまたは SNA サーバーは、INITSELF に否定的な応答を送信しました。

必要に応じて、ホストまたは SNA サーバーがフォーマットされていないログオン コマンドを送信している可能性があります。 これは、 が または INIT_LOGONにINIT_INITSELF設定されている場合initTypeにのみ当てはまります。
CLU0_E_BADPARM connectionStr に無効なプロパティ設定が含まれていました。
CLU0_E_NOFREELU で luname 指定された LU は SNA サーバー LU プールです。 現在、プールには無料の LU はありません。
CLU0_E_LUINUSE で luname 指定された LU は SNA サーバー LU です。 この LU は現在、別のアプリケーションで使用されています。
CLU0_E_LUNOTFOUND LU またはプール名が存在しません。
CLU0_E_TIMEDOUT 指定されたタイムアウト内にセッションが開始されませんでした。
CLU0_E_SESSION_FAILED セッションのアクティブ化に失敗し、TSS LU0 セッションに接続されていません。

アプリケーションは、同じまたは異なる接続プロパティを使用して新しいセッションを作成するか、別の TSS セッション ハンドルに接続する必要があります。
CLU0_E_ACCESSDENIED クライアントのユーザー アカウントに、要求された LU またはプールを使用するアクセス許可がありません。
CLU0_E_ALREADY_CONNECTED comLU0 クライアントは既に別のセッションに接続されています。
CLU0_E_SYSERROR 内部エラーが原因で失敗しました。

注釈

次の表に、 で使用できる値を initType示します。

名前 値 説明
INIT_BIND 0 PLU から未承諾の BIND と SDT を待機します。
INIT_SSCP 1 BIND と SDT が到着するまで待ちますが、アプリケーションが SSCP データとコマンドを送信するための SSCP セッションへのアクセスを許可します。
INIT_INITSELF 2 で data指定された INITSELF コマンドを送信した後、BIND と SDT が到着するまで待ちます。
INIT_LOGON 3 で data指定された UNFORMATTED SSCP ログオン メッセージを送信した後、BIND と SDT が到着するまで待ちます。

参照

IcomLU0 メソッド
LU0 のセッション インテグレーター