共用方式為


CmRegisterCallback 函式 (wdm.h)

CmRegisterCallback 例程已過時,適用於 Windows Vista 和更新版本的操作系統版本。 請改用 CmRegisterCallbackEx

CmRegisterCallback 例程會註冊 RegistryCallback 例程。

語法

NTSTATUS CmRegisterCallback(
  [in]           PEX_CALLBACK_FUNCTION Function,
  [in, optional] PVOID                 Context,
  [out]          PLARGE_INTEGER        Cookie
);

參數

[in] Function

要註冊之 RegistryCallback 例程的指標。

[in, optional] Context

組態管理員將作為 CallbackContext 參數傳遞至 RegistryCallback 例程的驅動程式定義值

[out] Cookie

LARGE_INTEGER變數的指標,可接收識別回呼例程的值。 當您取消註冊回呼例程時,請將此值當做 Cookie 參數傳遞至 CmUnRegisterCallback

傳回值

如果作業成功,CmRegisterCallback 會傳回STATUS_SUCCESS,如果作業失敗,則傳回適當的 NTSTATUS 錯誤碼。

備註

CmRegisterCallback 例程適用於 Windows XP 和更新版本的作業系統版本。 針對 Windows Vista 和更新版本的作業系統版本,您應該改用 CmRegisterCallbackEx

驅動程式會呼叫 CmRegisterCallback 來註冊 RegistryCallback 例程,每次線程在登錄上執行作業時都會呼叫此例程。

呼叫 CmUnRegisterCallback 以取消註冊 CmRegisterCallback 註冊的回呼例程。

如需 CmRegisterCallback 和篩選登錄作業的詳細資訊,請參閱 篩選登錄呼叫

規格需求

需求
最低支援的用戶端 可在 Windows XP 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL <=APC_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) IrqlExApcLte2 (wdm)

另請參閱

CmRegisterCallbackEx

CmUnRegisterCallback

RegistryCallback