共用方式為

SetupDiOpenClassRegKeyExA 函式 （setupapi.h）

  • 發行項

SetupDiOpenClassRegKeyEx 函式會開啟 裝置安裝類別 登錄機碼、裝置介面類別 登錄機碼，或特定類別的子機碼。 此函式會在本機電腦或遠端電腦上開啟指定的金鑰。

語法

WINSETUPAPI HKEY SetupDiOpenClassRegKeyExA(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired,
  [in]           DWORD      Flags,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

參數

[in, optional] ClassGuid

要開啟登錄機碼之 類別之 GUID 的指標。 這個參數是選擇性的，而且可以 NULL。 如果此參數 NULL，則會開啟類別樹狀結構的根目錄（HKLM\SYSTEM\CurrentControlSet\Control\Class）。

[in] samDesired

要開啟之金鑰的登錄安全性存取。 如需 REGSAM 類型登錄安全性存取值的相關信息，請參閱 Microsoft Windows SDK 檔。

[in] Flags

要開啟的登錄機碼類型，由下列其中一項指定：

DIOCR_INSTALLER

開啟安裝類別索引鍵。 如果 ClassGuidNULL，請開啟類別安裝程式分支的根索引鍵。

DIOCR_INTERFACE

開啟介面類別索引鍵。 如果 ClassGuidNULL，請開啟介面類別分支的根索引鍵。

[in, optional] MachineName

選擇性地指向包含要開啟指定索引鍵之遠端電腦名稱的字串。

謹慎

從 Windows 8 和 Windows Server 2012 開始，不支援使用此函式來存取遠端電腦，因為此功能已移除。

Reserved

保留。 必須 NULL。

傳回值

SetupDiOpenClassRegKeyEx 會傳回已開啟登錄機碼的句柄，其中可以儲存/擷取此安裝程式類別的相關信息。

如果函式失敗，則會傳回INVALID_HANDLE_VALUE。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

根據傳入 samDesired 參數的值而定，此函式的呼叫端可能需要成為 Administrators 群組的成員。

SetupDiOpenClassRegKeyEx 如果登錄機碼不存在，則不會建立登錄機碼。

此函式的呼叫端必須藉由呼叫 RegCloseKey來關閉從此函式傳回的句柄。

注意

setupapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetupDiOpenClassRegKeyEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Microsoft Windows 2000 和更新版本的 Windows 中提供。
目標平臺 桌面
標頭 setupapi.h （包括 Setupapi.h）
連結庫 Setupapi.lib

另請參閱

SetupDiCreateDeviceInterfaceRegKey

SetupDiOpenDevRegKey