CM_Open_Device_Interface_KeyA Funktion (cfgmgr32.h)

Artikel
11/20/2024

Die funktion CM_Open_Device_Interface_Key öffnet den Registrierungsunterschlüssel, der von Anwendungen und Treibern zum Speichern von Informationen verwendet wird, die für eine Geräteschnittstelle spezifisch sind.

Syntax

CMAPI CONFIGRET CM_Open_Device_Interface_KeyA(
  [in]  LPCSTR         pszDeviceInterface,
  [in]  REGSAM         samDesired,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDeviceInterface,
  [in]  ULONG          ulFlags
);

Parameter

[in] pszDeviceInterface

Zeigen Sie auf eine Zeichenfolge, die die Geräteschnittstelleninstanz identifiziert, für die der Registrierungsunterschlüssel geöffnet werden soll.

[in] samDesired

Der angeforderte Registrierungssicherheitszugriff auf den Registrierungsunterschlüssel.

[in] Disposition

Gibt an, wie der Registrierungsschlüssel geöffnet werden soll. Es kann sich um einen der folgenden Werte handeln:

RegDisposition_OpenAlways

Öffnen Sie den Schlüssel, falls vorhanden. Erstellen Sie andernfalls den Schlüssel.

RegDisposition_OpenExisting

Öffnen Sie den Schlüssel nur, wenn er vorhanden ist.

[out] phkDeviceInterface

Zeigen Sie auf einen HKEY, der den geöffneten Schlüssel nach Erfolg erhält.

[in] ulFlags

Reserviert. Muss auf Null festgelegt werden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird eine der CR_-präfixierten Fehlercodes zurückgegeben, die in Cfgmgr32.hdefiniert sind.

Bemerkungen

Schließen Sie das von dieser Funktion zurückgegebene Handle, indem Sie RegCloseKeyaufrufen.

Anmerkung

Der cfgmgr32.h-Header definiert CM_Open_Device_Interface_Key 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 Vista und höheren Versionen von Windows.
Zielplattform-	Universal
Header-	cfgmgr32.h (enthalten Cfgmgr32.h)
Library	Cfgmgr32.lib

Siehe auch

SetupDiOpenDeviceInterfaceRegKey

Freigeben über