共用方式為

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

一組旗標，可修改此函式的行為。 此參數包含下列一或多個值的組合。

值 意義
NCRYPT_REGISTER_NOTIFY_FLAG
0x00000001
 建立新的變更通知。 phEvent 參數將會收到密鑰變更通知句柄。
NCRYPT_UNREGISTER_NOTIFY_FLAG
0x00000002
 拿掉現有的變更通知。 phEvent 參數必須包含有效的密鑰變更通知句柄。 使用此旗標呼叫此函式之後，這個句柄就不再有效，而且 會將INVALID_HANDLE_VALUE 值放在這個句柄中。
NCRYPT_MACHINE_KEY_FLAG
0x00000020
 接收計算機金鑰存放區中金鑰的變更通知。 如果未指定此旗標，變更通知事件只會發生在呼叫使用者的金鑰存放區中。 只有在與 NCRYPT_REGISTER_NOTIFY_FLAG 旗標結合時，此旗標才有效。

傳回值

傳回狀態代碼，指出函式的成功或失敗。

可能的傳回碼包括但不限於下列各項。

傳回碼 Description
ERROR_SUCCESS
 函式成功。
NTE_BAD_FLAGS
 dwFlags 參數包含無效的值。
NTE_INVALID_HANDLE
 hProvider 參數無效。
NTE_INVALID_PARAMETER
 一或多個參數無效。

備註

服務不得從它的 StartService 函式呼叫此函式。 如果服務從它的 StartService 函式呼叫此函式，可能會發生死結，而且服務可能會停止回應。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 ncrypt.h
程式庫 Ncrypt.lib
Dll Ncrypt.dll

另請參閱

FindFirstChangeNotification