CM_Open_Device_Interface_Key_ExW Funktion (cfgmgr32.h)

Artikel
11/20/2024

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Open_Device_Interface_Key.]

Die funktion CM_Open_Device_Interface_Key_ExW öffnet den Registrierungsunterschlüssel, der von Anwendungen und Treibern verwendet wird, um Informationen zu speichern, die für eine Geräteschnittstelle spezifisch sind.

Syntax

CMAPI CONFIGRET CM_Open_Device_Interface_Key_ExW(
  [in]           LPCWSTR        pszDeviceInterface,
  [in]           REGSAM         samDesired,
  [in]           REGDISPOSITION Disposition,
  [out]          PHKEY          phkDeviceInterface,
  [in]           ULONG          ulFlags,
  [in, optional] HMACHINE       hMachine
);

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.

[in, optional] hMachine

Vom Anrufer bereitgestellter Maschinenhandle, abgerufen von einem vorherigen Aufruf an CM_Connect_Machine.

Hinweis Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.

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_Ex 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 10 und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	cfgmgr32.h (enthalten Cfgmgr32.h)
Library	Cfgmgr32.lib

Siehe auch

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey

Freigeben über