ホーム › Security.Cryptography › NCryptNotifyChangeKeyFn

NCryptNotifyChangeKeyFn

コールバック

シグネチャ

HRESULT NCryptNotifyChangeKeyFn(
    NCRYPT_PROV_HANDLE hProvider,
    HANDLE* phEvent,
    DWORD dwFlags
);

パラメーター

フィールド

型

説明

hProvider

NCRYPT_PROV_HANDLE

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

phEvent

HANDLE*

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

dwFlags

DWORD

この関数の動作を変更するフラグのセットです。このパラメーターには、次の値のうち 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 フラグと組み合わせた場合にのみ有効です。

公式ドキュメント

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

この関数が提供するハンドルは、FindFirstChangeNotification 関数が返すハンドルと同じものです。通知ハンドルがシグナル状態になるのを待つには、待機関数を使用します。

戻り値

関数の成功または失敗を示すステータスコードを返します。

返される可能性のあるコードには、次のものが含まれますが、これらに限定されません。

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

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)