SetupDiOpenDeviceInterfaceRegKey-Funktion (setupapi.h)
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 |