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

Weitere Informationen

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceRegKey

SetupDiOpenDeviceInterfaceRegKey