一時停止状態

接続操作中に、リモート サーバーがローカル ユーザーからの追加情報なしで続行できない場合があります。 Windows NT 3.5 以降では、RasDial 関数は一時停止状態をサポートしています。 状態を一時停止すると、リモート アクセス 接続マネージャーは、RAS クライアント アプリケーションがユーザーから情報を収集できるように、接続操作を中断できます。

一時停止状態は、次の状況で役立ちます。

• ユーザーが コールバック 番号を指定する必要がある場合。
• ユーザー認証が失敗した場合、ユーザーは別のユーザー名とパスワードを入力できます。
• ユーザーのパスワードの有効期限が切れると、ユーザーは新しいパスワードを指定できます。

既定では、一時停止状態のサポートは無効になっています。 一時停止状態をサポートする RAS クライアントは、RasDial にパラメーターとして渡される RASDIALEXTENSIONS 構造体でRDEOPTS_PausedStates フラグを設定する必要があります。

一時停止状態が発生すると、リモート アクセス 接続マネージャーはクライアントの通知ハンドラーを呼び出します。 一時停止状態のサポートが無効になっている場合、通知メッセージはエラーを示し、接続操作は失敗します。 有効になっている場合、接続マネージャーは RAS クライアントの応答を待機するために接続操作を一時停止します。 RAS クライアントは、2 回目の RasDial 呼び出しによって接続操作を再開するか、 RasHangUp 関数を呼び出して終了できます。

ユーザーの入力を取得した後、RAS クライアントは RasDial をもう一度呼び出して接続操作を再開します。 この 2 回目 の RasDial 呼び出しでは、次の情報を指定する必要があります。

• 元の RasDial 呼び出しによって返された接続ハンドル。
• 元の RasDial 呼び出しと同じ通知ハンドラー。
• RASDIALPARAMS 構造体の適切なメンバーでのユーザーの入力。 RASDIALPARAMS 構造体の他のメンバーは、元の RasDial 呼び出しで指定されたものと同じ情報を持つ必要があります。

2 番目の RasDial 呼び出しは、通知ハンドラー内から行うことはできません。