BCryptRegisterConfigChangeNotify 関数 (bcrypt.h)

  • [アーティクル]

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

BCryptRegisterConfigChangeNotify(HANDLE*) 関数は、ユーザー モードの CNG 構成変更イベント ハンドラーを作成します。

構文

NTSTATUS BCryptRegisterConfigChangeNotify(
  [out] PRKEVENT pEvent
);

パラメーター

[out] pEvent

イベント ハンドルを受け取る HANDLE 変数のアドレス。 WaitForSingleObject などの待機関数のいずれかを使用して、イベントがいつ通知されたかを判断します。 イベントは名前が指定されておらず、手動リセット イベントである必要があります。 イベントは、CNG 構成データが変更されたときに通知されます。

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

戻り値

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

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

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

注釈

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

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

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー bcrypt.h
Library Bcrypt.lib
[DLL] Bcrypt.dll

こちらもご覧ください

BCryptUnregisterConfigChangeNotify(HANDLE)