funzione CM_Open_DevNode_Key (cfgmgr32.h)

La funzione CM_Open_DevNode_Key apre una chiave del Registro di sistema per informazioni di configurazione specifiche del dispositivo.

Sintassi

CMAPI CONFIGRET CM_Open_DevNode_Key(
  [in]  DEVINST        dnDevNode,
  [in]  REGSAM         samDesired,
  [in]  ULONG          ulHardwareProfile,
  [in]  REGDISPOSITION Disposition,
  [out] PHKEY          phkDevice,
  [in]  ULONG          ulFlags
);

Parametri

[in] dnDevNode

Handle di istanza del dispositivo fornito dal chiamante associato al computer locale

[in] samDesired

Accesso alla sicurezza del Registro di sistema necessario per la chiave richiesta.

[in] ulHardwareProfile

Il profilo hardware da aprire se ulFlags include CM_REGISTRY_CONFIG. Se questo valore è zero, viene aperta la chiave per il profilo hardware corrente.

[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] phkDevice

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

[in] ulFlags

Aprire i flag di chiave del nodo del dispositivo. Indica l'ambito e il tipo di chiave di archiviazione del Registro di sistema da aprire. Può essere una combinazione dei flag seguenti:

CM_REGISTRY_HARDWARE

Aprire la chiave hardware del dispositivo. Non combinare con CM_REGISTRY_SOFTWARE.

CM_REGISTRY_SOFTWARE

Aprire la chiave software del dispositivo. Non combinare con CM_REGISTRY_HARDWARE.

CM_REGISTRY_USER

Aprire la chiave per utente per l'utente corrente. Non combinare con CM_REGISTRY_CONFIG.

CM_REGISTRY_CONFIG

Aprire la chiave che archivia le informazioni di configurazione specifiche del profilo hardware. Non combinare con CM_REGISTRY_USER.

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.

Requisiti

Vedi anche

CM_Delete_DevNode_Key

SetupDiOpenDevRegKey