funzione CM_Open_Device_Interface_KeyA (cfgmgr32.h)

Articolo
11/20/2024

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

Sintassi

CMAPI CONFIGRET CM_Open_Device_Interface_KeyA(
  [in]  LPCSTR         pszDeviceInterface,
  [in]  REGSAM         samDesired,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDeviceInterface,
  [in]  ULONG          ulFlags
);

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 alla sottochiave del Registro di sistema richiesto.

[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 esistente. In caso contrario, creare la chiave.

RegDisposition_OpenExisting

Aprire la chiave solo se esistente.

[out] phkDeviceInterface

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

[in] ulFlags

Riservato. Deve essere impostato su zero.

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.

Osservazioni

Chiudere l'handle restituito da questa funzione chiamando RegCloseKey.

Nota

L'intestazione cfgmgr32.h definisce CM_Open_Device_Interface_Key come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Microsoft Windows Vista e versioni successive di Windows.
piattaforma di destinazione	Universale
intestazione	cfgmgr32.h (include Cfgmgr32.h)
libreria	Cfgmgr32.lib

Vedere anche

SetupDiOpenDeviceInterfaceRegKey

Condividi tramite