新しい 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 ログオン メッセージを含む符号なし文字型の配列をポインターします。
initTypeにINIT_INITSELFまたはINIT_LOGONが含まれている場合にのみ使用されます。 |
timeout |
BIND コマンドと SDT コマンドが到着するまで待機する時間 (ミリ秒単位)。 SDT が到着する前にタイムアウトが切れると、SNA サーバー LU が解放され、エラーが返されます。0xfffffffにtimeoutを入力すると、無限の待機時間が示されます。 |
sessionHandle |
このメソッドが正常に返されると、基になる LU0 セッションを表す comLU0 セッション オブジェクトへの IUnknown インターフェイスへのポインターが含まれます。 このインターフェイスへの参照が保持されるのと同様に、セッション オブジェクトはそのまま残ります。 このインターフェイスを IcomLU0.Connect メソッドに渡して、セッションを使用して comLU0 オブジェクトに接続できます。 LU プロパティが指定されていない場合、comLU0 は、実行しているユーザー アカウントに割り当てられている使用可能な最適な LU を選択します。 |
戻り値
次の表では、CreateSession のリターン コードについて説明します。
| 価値 | 説明 |
|---|---|
| S_OK | LU0 セッションが正常に作成されました。 LU セッションはアクティブであり、入力を受け取る準備ができています。 |
| CLU0_S_SSCP_ACTIVE | LU0 セッションが正常に作成されました。 SSCP セッションはアクティブであり、入力を受信する準備ができています。 このリターン コードは、 initType が INIT_SSCP に設定されている場合にのみ有効です。 |
| CLU0_E_NEG_RESPONSE | ホストまたは SNA サーバーが INITSELF に否定応答を送信しました。 必要に応じて、ホストまたは SNA サーバーがフォーマットされていないログオン コマンドを送信している可能性があります。 これは、 initType が INIT_INITSELF または INIT_LOGON に設定されている場合にのみ当てはまります。 |
| 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 が到着するまで待ちます。 |