CM_Open_Device_Interface_KeyW-Funktion (cfgmgr32.h)
Die CM_Open_Device_Interface_Key-Funktion ö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_KeyW(
[in] LPCWSTR pszDeviceInterface,
[in] REGSAM samDesired,
[in] REGDISPOSITION Disposition,
[out] PHKEY phkDeviceInterface,
[in] ULONG ulFlags
);
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 er vorhanden ist. 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 nach erfolgreicher Ausführung erhält.
[in] ulFlags
Reserviert. Muss auf 0 festgelegt werden.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.
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 als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 Vista und höheren Versionen von Windows. |
Zielplattform | Universell |
Header | cfgmgr32.h (einschließlich Cfgmgr32.h) |
Bibliothek | Cfgmgr32.lib |