funzione CM_Open_Device_Interface_Key_ExA (cfgmgr32.h)

  • Articolo

[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata. Usare invece CM_Open_Device_Interface_Key .]

La funzione CM_Open_Device_Interface_Key_ExA apre la sottochiave del Registro di sistema usata da applicazioni e driver per archiviare informazioni specifiche di un'interfaccia del dispositivo.

Sintassi

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
);

Parametri

[in] pszDeviceInterface

Puntatore a una stringa che identifica l'istanza dell'interfaccia del dispositivo per aprire la sottochiave del Registro di sistema.

[in] samDesired

Accesso richiesto alla sottochiave del Registro di sistema.

[in] Disposition

Specifica la modalità di apertura della chiave del Registro di sistema. Può essere uno dei valori seguenti:

RegDisposition_OpenAlways

Aprire la chiave se esiste. In caso contrario, creare la chiave.

RegDisposition_OpenExisting

Aprire la chiave solo se esiste.

[out] phkDeviceInterface

Puntatore a un HKEY che riceverà la chiave aperta al termine dell'esito positivo.

[in] ulFlags

Riservato. Deve essere impostato su zero.

[in, optional] hMachine

Handle del computer fornito dal chiamante, ottenuto da una chiamata precedente a CM_Connect_Machine.

Nota L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.
 

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Commenti

Chiudere l'handle restituito da questa funzione chiamando RegCloseKey.

Nota

L'intestazione cfgmgr32.h definisce CM_Open_Device_Interface_Key_Ex come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 10 e versioni successive di Windows.
Piattaforma di destinazione Desktop
Intestazione cfgmgr32.h (include Cfgmgr32.h)
Libreria Cfgmgr32.lib

Vedi anche

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey