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
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.
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 |