funzione CM_Open_Class_KeyW (cfgmgr32.h)
La funzione CM_Open_Class_Key apre la chiave del Registro di sistema della classe di installazione del dispositivo, la chiave del Registro di sistema della classe dell'interfaccia del dispositivo o una sottochiave specifica di una classe.
Sintassi
CMAPI CONFIGRET CM_Open_Class_KeyW(
[in, optional] LPGUID ClassGuid,
[in, optional] LPCWSTR pszClassName,
[in] REGSAM samDesired,
[in] REGDISPOSITION Disposition,
[out] PHKEY phkClass,
[in] ULONG ulFlags
);
Parametri
[in, optional] ClassGuid
Puntatore al GUID della classe la cui chiave del Registro di sistema deve essere aperta. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, viene aperta la radice dell'albero della classe.
[in, optional] pszClassName
Riservato. Deve essere impostato su NULL.
[in] samDesired
Accesso alla sicurezza del Registro di sistema per l'apertura della chiave.
[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] phkClass
Puntatore a un HKEY che riceverà la chiave aperta al termine dell'esito positivo.
[in] ulFlags
Aprire i flag delle chiavi di classe:
CM_OPEN_CLASS_KEY_INSTALLER
La chiave da aprire è per una classe di installazione del dispositivo.
CM_OPEN_CLASS_KEY_INTERFACE
La chiave da aprire è per una classe di interfaccia del dispositivo.
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 | Desktop |
| Intestazione | cfgmgr32.h (include Cfgmgr32.h) |
| Libreria | Cfgmgr32.lib |