WdfRegistryWdmGetHandle 函式 (wdfregistry.h)

[適用於 KMDF 和 UMDF]

WdfRegistryWdmGetHandle 方法會傳回 Windows 驅動程式模型 (WDM) 句柄給指定的架構登錄機碼物件所代表的登錄機碼。

語法

HANDLE WdfRegistryWdmGetHandle(
  [in] WDFKEY Key
);

[in] Key

表示已開啟登錄機碼之登錄機碼物件的句柄。

WdfRegistryWdmGetHandle 會將 WDM 句柄傳回登錄機碼。

如果驅動程式提供無效的物件句柄，就會發生錯誤檢查。

KMDF 驅動程式可以將傳回的 WDM 句柄傳遞至接受 WDM 句柄做為輸入的 ZwXxx 例程。

UMDF 驅動程式可以將傳回的句柄傳遞至需要 HKEY 的 API，例如 RegEnumKeyEx。

WdfRegistryWdmGetHandle 方法傳回的句柄有效，直到刪除登錄機碼對象為止。如果驅動程式為登錄機碼物件提供 EvtCleanupCallback 函式，則指標會有效，直到回呼函式傳回為止。

如需登錄機碼對象的詳細資訊，請參閱在 Framework-Based Drivers 中使用登錄。

下列程式代碼範例會取得指定之架構登錄機碼物件所代表之登錄機碼的WDM句柄。

HANDLE hKey;

hKey = WdfRegistryWdmGetHandle(Key);