指定內容資訊

組態管理員提供數種方式,讓登錄篩選驅動程式將內容資訊指派給登錄作業。 登錄篩選驅動程式可以:

  • 將內容資訊指派給 RegistryCallback 常式。

    當您的驅動程式呼叫 CmRegisterCallbackCmRegisterCallbackEx 以註冊登錄作業的通知時,驅動程式可以指定驅動程式定義的內容值。 組態管理員會在每次組態管理員呼叫常式時,將此內容值傳遞至驅動程式的 RegistryCallback 常式。

    從 Windows XP 開始,支援此內容資訊。

  • 將內容資訊指派給登錄作業。

    驅動程式可以將作業特定內容資訊儲存在每個REG_XXXCallCoNtext成員中_KEY_INFORMATION驅動程式的RegistryCallback常式接收的結構中。 如果您的驅動程式同時收到登錄作業的通知前通知和後置通知, REG_POST_OPERATION_INFORMATION 結構會包含適當通知結構的指標。 當 RegistryCallback 常式收到REG_POST_OPERATION_INFORMATION結構 ,該結構的 CallCoNtext 成員會符合預先通知結構的 CallCoNtext 成員。

    這些結構的 CallCoNtext 成員可從 Windows Vista 開始取得。

  • 將內容資訊指派給登錄機碼物件。

    RegistryCallback常式可以將內容資訊指派給特定的登錄機碼物件。 如果RegistryCallback常式呼叫CmSetCallbackObjectCoNtext將內容資訊指派給索引鍵物件,則物件上所有作業的後續通知和後置通知都會包含每個REG_XXXObjectCoNtext成員的內容值_KEY_INFORMATION結構。 如果驅動程式提供多個 RegistryCallback 常式,驅動程式可以針對單一登入機碼物件,為每個常式指派不同的內容資訊。

    如果驅動程式已呼叫 CmSetCallbackObjectCoNtext,驅動程式的 RegistryCallback 常式會在金鑰組象的控制碼關閉之後收到 RegNtCallbackObjectCoNtextCleanup 通知。 為了回應此通知,常式應該釋放為物件內容配置的任何資源。 當RegistryCallback常式的Argument1參數是RegNtCallbackObjectCoNtextCleanup時,Argument2參數是包含內容指標的REG_CALLBACK_CONTEXT_CLEANUP_INFORMATION結構指標。

    CmSetCallbackObjectCoNtext常式和RegNtCallbackObjectCoNtextCleanup通知可從 Windows Vista 開始使用。