RasSecurityDialogEnd 関数 (rasshost.h)

RasSecurityDialogEnd 関数は、RAS サーバーが認証トランザクションを終了するために呼び出すサードパーティの RAS セキュリティ DLL エントリ ポイントです。

構文

DWORD RasSecurityDialogEnd(
  [in] HPORT hPort
);

パラメーター

[in] hPort

RAS サーバーがこの認証トランザクションの RasSecurityDialogBegin 呼び出しでセキュリティ DLL に渡すポート ハンドルを指定します。

戻り値

セキュリティ DLL から NO_ERRORが返された場合、RAS サーバーは認証トランザクションを終了しません。 この場合、セキュリティ DLL は、終了する準備ができたら、後で RasSecurityDialogComplete 関数を呼び出す必要があります。

セキュリティ DLL から 0 以外のエラー コードが返された場合、RAS サーバーは認証トランザクションを終了します。 この場合、セキュリティ DLL は、別の RasSecurityDialogComplete 呼び出しを行う必要はありません。 Winerror.h または Raserror.h で定義されているエラー コード (ERROR_PORT_DISCONNECTEDなど) を返します。

注釈

セキュリティ DLL がリモート ユーザーの認証を完了すると、 RasSecurityDialogComplete 関数が呼び出されます。 次に、RAS サーバーは、DLL の RasSecurityDialogEnd 関数の呼び出しを含むクリーンアップ シーケンスを実行します。 これにより、セキュリティ DLL に必要なクリーンアップを実行する機会が与えます。 認証トランザクションを終了するには、 RasSecurityDialogEnd から 0 以外のエラー コードが返される必要があります。

RAS サーバーは、セキュリティ DLL が RasSecurityDialogComplete を呼び出す前に認証トランザクションを異常終了する必要がある場合に 、RasSecurityDialogEnd を呼び出すこともできます。 この場合、セキュリティ DLL は hPort ポート ハンドルに関連付けられているワーカー スレッドを終了し、その他の必要なクリーンアップを実行する必要があります。 RasSecurityDialogEnd が 0 以外の値を返す場合、セキュリティ DLL は RasSecurityDialogComplete を呼び出す必要はありません。

通常の終了と異常終了の両方について、 RasSecurityDialogEnd 関数はNO_ERRORを返して終了を遅延させます。 その場合は、終了する準備ができたら、後で RasSecurityDialogComplete を呼び出す必要があります。

要件

こちらもご覧ください

RAS サーバー管理機能

RasSecurityDialogBegin

RasSecurityDialogComplete

リモート アクセス サービス (RAS) の概要