CM_Open_Device_Interface_Key_ExW 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_ExW öffnet den Registrierungsunterschlüssel, der von Anwendungen und Treibern verwendet wird, um Informationen zu speichern, 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

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.

Anforderungen

Siehe auch

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey