SetupDiCreateDeviceInterfaceRegKeyA-Funktion (setupapi.h)
Die SetupDiCreateDeviceInterfaceRegKey-Funktion erstellt einen Registrierungsschlüssel zum Speichern von Informationen über eine 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 zu einem 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 SetupDiCreateDeviceInterfacezurückgegeben.
Reserved
Reserviert. Muss null sein.
[in] samDesired
Der Registrierungssicherheitszugriff, den der Aufrufer für den erstellten Schlüssel anfordert. Informationen zu Registrierungssicherheitszugriffswerten vom Typ REGSAM finden Sie in der Microsoft Windows SDK-Dokumentation.
[in, optional] InfHandle
Das Handle zu einer geöffneten 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-werden. 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 durch InfHandle-angegeben wird. Dieser Abschnitt wird für den neu erstellten Schlüssel ausgeführt. Dieser Parameter ist optional und kann NULL-werden. 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.
Bemerkungen
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 an diesen Schlüssel zurück. andernfalls erstellt SetupDiCreateDeviceInterfaceRegKey einen neuen nichtvolatile 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 mit IoXxx Routinen auf diesen Schlüssel zugreifen.
Schließen Sie das von dieser Funktion zurückgegebene Handle, indem Sie RegCloseKeyaufrufen.
Für Installationen, die Layoutdateien verwenden (angegeben durch den LayoutFile- Eintrag in einem Abschnitt INF-Version), muss die Layoutdatei durch einen Aufruf von SetupOpenAppendInfFile- (in der Windows SDK-Dokumentation beschrieben) geöffnet werden, bevor SetupDiCreateDeviceInterfaceRegKey aufgerufen wird.
Die durch DeviceInfoSet- angegebenen Geräteinformationen dürfen nur Elemente auf dem lokalen Computer enthalten.
Anmerkung
Der header setupapi.h 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | setupapi.h (include Setupapi.h) |
| Library | Setupapi.lib |