Share via

BCryptRegisterConfigChangeNotify

  • [アーティクル]

[BCryptRegisterConfigChangeNotify は、Windows 10 以降非推奨です。]

BCryptRegisterConfigChangeNotify(PRKEVENT) 関数は、カーネル モード CNG 構成変更イベント ハンドラーを作成します。

構文

NTSTATUS BCryptRegisterConfigChangeNotify(
  [in] HANDLE *phEvent
);

パラメーター

[in] phEvent

イベント ディスパッチャー オブジェクトへのポインターを受け取る PRKEVENT 変数のアドレス。 WaitForSingleObject などのカーネル待機関数を使用して、イベントがいつ通知されたかを判断します。 イベントは、CNG 構成が変更されたときに通知されます。

イベント通知を削除するには、このハンドルを BCryptUnregisterConfigChangeNotify(PRKEVENT) 関数に渡す必要があります。

戻り値

関数の成功または失敗を示す状態コードを返します。

可能なリターン コードには、次のものが含まれますが、これらに限定されません。

リターン コード 説明
STATUS_SUCCESS
 関数は成功しました。
STATUS_INVALID_PARAMETER
 phEvent パラメーターが無効です。
STATUS_NO_MEMORY
 メモリ割り当てエラーが発生しました。

注釈

phEvent パラメーターによって指される変数で返されるハンドルは、CNG 構成への変更が発生したときに通知されます。

BCryptRegisterConfigChangeNotify(HANDLE*) は、ユーザー モードでのみ呼び出すことができます。 カーネル モードで実行するコードでは 、BCryptRegisterConfigChangeNotify(PRKEVENT) を呼び出す必要があります。 BCryptRegisterConfigChangeNotify(PRKEVENT) は、カーネル モードと PASSIVE_LEVEL IRQL でのみ呼び出すことができます。 ユーザー モードで実行するコードは 、BCryptRegisterConfigChangeNotify(HANDLE*) を呼び出す必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 10 ビルド 20348
サポートされている最小のサーバー Windows 10 ビルド 20348
Header bcrypt.h

こちらもご覧ください

BCryptUnregisterConfigChangeNotify(PRKEVENT) 関数