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

Vedi anche

CM_Delete_Class_Key

SetupDiOpenClassRegKeyEx