CmRegisterCallback-Funktion (wdm.h)

Die CmRegisterCallback Routine ist veraltete für Windows Vista und spätere Betriebssystemversionen. Verwenden Sie stattdessen CmRegisterCallbackEx-.

Die CmRegisterCallback Routine registriert eine RegistryCallback Routine.

Syntax

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

Parameter

[in] Function

Ein Zeiger auf die RegistryCallback Routine, die registriert werden soll.

[in, optional] Context

Ein treiberdefinierter Wert, den der Konfigurations-Manager als CallbackContext Parameter an die RegistryCallback Routine übergeben wird

[out] Cookie

Ein Zeiger auf eine LARGE_INTEGER Variable, die den Wert empfängt, der die Rückrufroutine identifiziert. Wenn Sie die Registrierung der Rückrufroutine aufheben, übergeben Sie diesen Wert als Cookie Parameter an CmUnRegisterCallback.

Rückgabewert

CmRegisterCallback- gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist oder der entsprechende NTSTATUS Fehlercode zurückgegeben wird, wenn er fehlschlägt.

Bemerkungen

Die CmRegisterCallback Routine ist unter Windows XP und höheren Betriebssystemversionen verfügbar. Für Windows Vista und höhere Betriebssystemversionen sollten Sie stattdessen CmRegisterCallbackEx- verwenden.

Ein Treiber ruft CmRegisterCallback- auf, um eine RegistryCallback Routine zu registrieren, die jedes Mal aufgerufen wird, wenn ein Thread einen Vorgang in der Registrierung ausführt.

Rufen Sie CmUnRegisterCallback- auf, um die Registrierung einer Rückrufroutine aufzuheben, die CmRegisterCallback registriert.

Weitere Informationen zu CmRegisterCallback-- und Filterregistrierungsvorgängen finden Sie unter Filtern von Registrierungsaufrufen.

Anforderungen

Siehe auch

CmRegisterCallbackEx-

CmUnRegisterCallback-

RegistryCallback-