SetupDiCreateDeviceInterfaceRegKeyW-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 SetupDiCreateDeviceInterfaceRegKeyW(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved,
[in] REGSAM samDesired,
[in, optional] HINF InfHandle,
[in, optional] PCWSTR 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 schlüssel anfordert, der erstellt wird. Informationen zu Registrierungssicherheitszugriffswerten des Typs 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, die 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 zu erhalten.
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 LayoutFile-Eintrag in einem INF-Versionsabschnitt), muss die Layoutdatei durch einen Aufruf von SetupOpenAppendInfFile (beschrieben in Windows SDK Dokumentation) 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 die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, 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 (schließen Sie Setupapi.h ein) |
Bibliothek | Setupapi.lib |