共用方式為


CRegKey::NotifyChangeKeyValue

這個方法會告知變更呼叫端存取開啟登錄機碼的屬性或內容。

LONG NotifyChangeKeyValue(
   BOOL bWatchSubtree,
   DWORD dwNotifyFilter,
   HANDLE hEvent,
   BOOL bAsync = TRUE 
) throw( );

參數

  • bWatchSubtree
    指定是否要報告只會變更在指定的機碼及其一切子機碼或在指定的機碼上的旗標。如果此參數為 true 時,方法會報告在機碼及其子機碼的變更。如果參數為 false,則方法會報告只會變更在機碼中。

  • dwNotifyFilter
    指定控制項變更應該報告的旗標集。這個參數可以是下列值的組合:

    意義

    REG_NOTIFY_CHANGE_NAME

    如果子機碼加入或刪除,請告知呼叫端。

    REG_NOTIFY_CHANGE_ATTRIBUTES

    變更告知呼叫端存取金鑰的屬性,例如安全性描述元資訊。

    REG_NOTIFY_CHANGE_LAST_SET

    變更告知呼叫端存取索引鍵的值。這可包括加入或刪除值或變更現有的值。

    REG_NOTIFY_CHANGE_SECURITY

    變更告知呼叫端存取金鑰的安全性描述元 (Security Descriptor)。

  • hEvent
    為事件的控制代碼。如果 bAsync 參數為 true 時,方法會立即傳回,而且變更藉由發出信號的事件報告。如果 bAsync 為 false, hEvent 被忽略。

  • bAsync
    指示指定的旗標方法如何報告變更。如果此參數為 true 時,方法會立即傳回,而報告藉由發出信號的事件指定變更。當這個參數為 false 時,方法不會傳回,直到發生變更。如果 hEvent 沒有指定有效的事件, bAsync 參數不可以是 true。

傳回值

如果方法成功,則傳回值為 ERROR_SUCCESS。如果方法失敗,則傳回值是在 WINERROR.H. 定義的非零的錯誤碼。

備註

注意事項注意事項

如果指定的機碼已經刪除,這個方法不會告知呼叫端。

如需詳細資訊和範例程式,請參閱 RegNotifyChangeKeyValue

需求

Header: atlbase.h

請參閱

參考

CRegKey 類別