NCryptNotifyChangeKey 関数 (ncrypt.h)

  • [アーティクル]

NCryptNotifyChangeKey 関数は、キー変更通知を作成または削除します。

この関数によって提供されるハンドルは、 FindFirstChangeNotification 関数によって返されるのと同じハンドルです。 通知ハンドルが通知されるまで待機 関数 を使用して待機します。

構文

SECURITY_STATUS NCryptNotifyChangeKey(
  [in]      NCRYPT_PROV_HANDLE hProvider,
  [in, out] HANDLE             *phEvent,
  [in]      DWORD              dwFlags
);

パラメーター

[in] hProvider

キー ストレージ プロバイダーのハンドル。 このハンドルは、 NCryptOpenStorageProvider 関数を使用して取得されます。

[in, out] phEvent

キー変更通知イベント ハンドルを受け取るか含む HANDLE 変数のアドレス。 これは、 FindFirstChangeNotification 関数によって返されるのと同じハンドルです。 詳細については、 dwFlags パラメーターの説明を参照してください。

[in] dwFlags

この関数の動作を変更するフラグのセット。 このパラメーターには、次の値の 1 つ以上の組み合わせが含まれています。

値 意味
NCRYPT_REGISTER_NOTIFY_FLAG
0x00000001
 新しい変更通知を作成します。 phEvent パラメーターは、キー変更通知ハンドルを受け取ります。
NCRYPT_UNREGISTER_NOTIFY_FLAG
0x00000002
 既存の変更通知を削除します。 phEvent パラメーターには、有効なキー変更通知ハンドルが含まれている必要があります。 このフラグを使用してこの関数が呼び出され、 INVALID_HANDLE_VALUE 値がこのハンドルに配置された後、このハンドルは無効になります。
NCRYPT_MACHINE_KEY_FLAG
0x00000020
 マシン キー ストア内のキーの変更通知を受け取ります。 このフラグが指定されていない場合、変更通知イベントは、呼び出し元のユーザーのキー ストア内のキーに対してのみ発生します。 このフラグは、 NCRYPT_REGISTER_NOTIFY_FLAG フラグと組み合わせた場合にのみ有効です。

戻り値

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

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

リターン コード 説明
ERROR_SUCCESS
 関数は成功しました。
NTE_BAD_FLAGS
 dwFlags パラメーターに無効な値が含まれています。
NTE_INVALID_HANDLE
 hProvider パラメーターが無効です。
NTE_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。

注釈

サービスは 、StartService 関数からこの関数を呼び出してはなりません。 サービスが StartService 関数からこの関数を呼び出すと、デッドロックが発生し、サービスが応答を停止する可能性があります。

要件

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

こちらもご覧ください

FindFirstChangeNotification