SetupDiCreateDeviceInterfaceRegKeyA-Funktion (setupapi.h)
Die SetupDiCreateDeviceInterfaceRegKey-Funktion erstellt einen Registrierungsschlüssel zum Speichern von Informationen zu einer Geräteschnittstelle und gibt ein Handle an den Schlüssel zurück.
Syntax
WINSETUPAPI HKEY SetupDiCreateDeviceInterfaceRegKeyA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved,
[in] REGSAM samDesired,
[in, optional] HINF InfHandle,
[in, optional] PCSTR InfSectionName
);
Parameter
[in] DeviceInfoSet
Ein Handle für einen Geräteinformationssatz , der die Schnittstelle enthält, für die ein Registrierungsschlüssel erstellt werden soll. Der Geräteinformationssatz darf keine Remoteelemente enthalten.
[in] DeviceInterfaceData
Ein Zeiger auf eine SP_DEVICE_INTERFACE_DATA-Struktur , die die Geräteschnittstelle in DeviceInfoSet angibt. Dieser Zeiger wird möglicherweise von SetupDiCreateDeviceInterface zurückgegeben.
Reserved
Reserviert. Muss Null sein.
[in] samDesired
Der Registrierungssicherheitszugriff, den der Aufrufer für den zu erstellenden Schlüssel anfordert. Informationen zu Registrierungssicherheitszugriffswerten vom Typ REGSAM finden Sie in der Microsoft Windows SDK-Dokumentation.
[in, optional] InfHandle
Das Handle für eine geöffnete INF-Datei, die einen DDInstall-Abschnitt enthält, der für den neu erstellten Schlüssel ausgeführt werden soll. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter nicht NULL ist, muss auch InfSectionName angegeben werden.
[in, optional] InfSectionName
Ein Zeiger auf den Namen eines INF DDInstall-Abschnitts in der INF-Datei, der von InfHandle angegeben wird. Dieser Abschnitt wird für den neu erstellten Schlüssel ausgeführt. Dieser Parameter ist optional und kann NULL sein. Wenn dieser Parameter angegeben ist, muss auch InfHandle angegeben werden.
Rückgabewert
Wenn SetupDiCreateDeviceInterfaceRegKey erfolgreich ist, gibt die Funktion ein Handle an den angeforderten Registrierungsschlüssel zurück, in dem Schnittstelleninformationen gespeichert und abgerufen werden können. Wenn SetupDiCreateDeviceInterfaceRegKey fehlschlägt, gibt die Funktion INVALID_HANDLE_VALUE zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Der Aufrufer dieser Funktion muss Mitglied der Gruppe Administratoren sein.
Wenn der angeforderte Schlüssel für die Geräteschnittstelle bereits vorhanden ist, gibt SetupDiCreateDeviceInterfaceRegKey ein Handle für diesen Schlüssel zurück. Andernfalls erstellt SetupDiCreateDeviceInterfaceRegKey einen neuen nicht flüchtigen Registrierungsschlüssel für die angegebene Geräteschnittstelle. Aufrufer dieser Funktion können private Konfigurationsdaten für die Geräteschnittstelle in diesem Schlüssel speichern. Der Treiber für das Gerät kann mithilfe von IoXxx-Routinen auf diesen Schlüssel zugreifen.
Schließen Sie das von dieser Funktion zurückgegebene Handle, indem Sie RegCloseKey aufrufen.
Bei Installationen, die Layoutdateien verwenden (angegeben durch den Eintrag LayoutFile im Abschnitt in einer INF-Version), muss die Layoutdatei durch einen Aufruf von SetupOpenAppendInfFile (in Windows SDK Dokumentation beschrieben) geöffnet werden, bevor SetupDiCreateDeviceInterfaceRegKey aufgerufen wird.
Der von DeviceInfoSet angegebene Geräteinformationssatz darf nur Elemente auf dem lokalen Computer enthalten.
Hinweis
Der setupapi.h-Header definiert SetupDiCreateDeviceInterfaceRegKey als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
| Bibliothek | Setupapi.lib |