SetupDiOpenClassRegKey 函式 (setupapi.h)

SetupDiOpenClassRegKey 函式會開啟安裝程式類別登錄機碼或特定類別的子機碼。

語法

WINSETUPAPI HKEY SetupDiOpenClassRegKey(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired
);

參數

[in, optional] ClassGuid

要開啟其索引鍵之安裝程序類別之 GUID 的指標。 此參數是選擇性的，可以是 NULL。 如果此參數為 NULL，則會開啟安裝程式類別樹狀目錄的根目錄 (HKLM\SYSTEM\CurrentControlSet\Control\Class) 。

[in] samDesired

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

傳回值

如果函式成功，它會傳回開啟之登錄機碼的句柄，其中可以儲存/擷取此安裝類別的相關信息。

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

備註

視在 samDesired 參數中傳遞的值而定，此函式的呼叫端可能需要成為 Administrators 群組的成員。

如果此函式不存在，則不會建立登錄機碼。

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

若要開啟介面類別登錄機碼或特定介面類別子機碼，請呼叫 SetupDiOpenClassRegKeyEx。

規格需求

另請參閱

SetupDiOpenClassRegKeyEx

SetupDiOpenDevRegKey