CM_Open_Device_Interface_KeyW Funktion (cfgmgr32.h)

Die funktion CM_Open_Device_Interface_Key ö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

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.

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.

Anforderungen

Siehe auch

SetupDiOpenDeviceInterfaceRegKey