CM_Open_Device_Interface_Key_ExA Funktion (cfgmgr32.h)
[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_ExA ö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_ExA(
[in] LPCSTR 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.
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 |