SetupDiOpenDeviceInterfaceRegKey-Funktion (setupapi.h)

  • Artikel

Die SetupDiOpenDeviceInterfaceRegKey-Funktion öffnet den Registrierungsunterschlüssel, der von Anwendungen und Treibern zum Speichern von Informationen verwendet wird, die für eine Geräteschnittstelle spezifisch sind.

Syntax

WINSETUPAPI HKEY SetupDiOpenDeviceInterfaceRegKey(
  [in] HDEVINFO                  DeviceInfoSet,
  [in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
       DWORD                     Reserved,
  [in] REGSAM                    samDesired
);

Parameter

[in] DeviceInfoSet

Ein Zeiger auf einen Geräteinformationssatz , der die Geräteschnittstelle enthält, für die ein Registrierungsunterschlüssel geöffnet werden soll.

[in] DeviceInterfaceData

Ein Zeiger auf eine SP_DEVICE_INTERFACE_DATA-Struktur , die die Geräteschnittstelle angibt. Dieser Zeiger kann von SetupDiCreateDeviceInterface oder SetupDiEnumDeviceInterfaces zurückgegeben werden.

Reserved

Reserviert. Muss Null sein.

[in] samDesired

Der angeforderte Registrierungssicherheitszugriff auf den Registrierungsunterschlüssel. Informationen zu Registrierungssicherheitszugriffswerten vom Typ REGSAM finden Sie in der Microsoft Windows SDK-Dokumentation.

Rückgabewert

SetupDiOpenDeviceInterfaceRegKey gibt ein Handle für den geöffneten Registrierungsschlüssel zurück. Wenn die Funktion fehlschlägt, gibt sie INVALID_HANDLE_VALUE zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Abhängig vom Wert, der im samDesired-Parameter übergeben wird, kann es erforderlich sein, dass der Aufrufer dieser Funktion Mitglied der Gruppe Administratoren ist.

Schließen Sie das von der Funktion zurückgegebene Handle, indem Sie RegCloseKey aufrufen.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop Für universellen Aufruf CM_Open_Device_Interface_Key
Kopfzeile setupapi.h (einschließlich Setupapi.h)
Bibliothek Setupapi.lib
DLL Setupapi.dll

Weitere Informationen

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey

SetupDiEnumDeviceInterfaces