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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | cfgmgr32.h (include Cfgmgr32.h) |
| Libreria | Cfgmgr32.lib; OneCoreUAP.lib in Windows 10 |
| DLL | CfgMgr32.dll |