CM_Open_Device_Interface_Key_ExW-Funktion (cfgmgr32.h)

  • Artikel

[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 zum Speichern von Informationen verwendet wird, 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

Zeiger auf eine Zeichenfolge, die die Geräteschnittstelle identifiziert, für die instance, 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. Kann einer der folgenden Werte sein:

RegDisposition_OpenAlways

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

RegDisposition_OpenExisting

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

[out] phkDeviceInterface

Zeiger auf einen HKEY, der den geöffneten Schlüssel bei Erfolg empfängt.

[in] ulFlags

Reserviert. Muss auf 0 (null) festgelegt werden.

[in, optional] hMachine

Vom Aufrufer bereitgestellter Maschinenhandle, der aus einem vorherigen Aufruf von CM_Connect_Machine abgerufen wurde.

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 einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.

Hinweise

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

Hinweis

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
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 10 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (include Cfgmgr32.h)
Bibliothek Cfgmgr32.lib

Weitere Informationen

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey