Funzione IoOpenDriverRegistryKey (wdm.h)

La routine IoOpenDriverRegistryKey restituisce un handle a una chiave del Registro di sistema specifica del driver per un determinato driver.

Sintassi

NTSTATUS IoOpenDriverRegistryKey(
  [in]  PDRIVER_OBJECT     DriverObject,
  [in]  DRIVER_REGKEY_TYPE RegKeyType,
  [in]  ACCESS_MASK        DesiredAccess,
  [in]  ULONG              Flags,
  [out] PHANDLE            DriverRegKey
);

Parametri

[in] DriverObject

Puntatore a una struttura DRIVER_OBJECT . Questa struttura deve essere l'oggetto driver per il driver chiamante.

[in] RegKeyType

Enumerazione di tipo DRIVER_REGKEY_TYPE che indica il tipo della chiave del Registro di sistema richiesta.

[in] DesiredAccess

Specifica il valore ACCESS_MASK che rappresenta i diritti di accesso necessari per la chiave. Per una descrizione di ogni KEY_XXX diritto di accesso, vedere ZwCreateKey .

[in] Flags

Imposta su zero.

[out] DriverRegKey

Puntatore alla variabile HANDLE che, in caso di esito positivo, contiene un handle per la chiave del Registro di sistema richiesta.

Valore restituito

IoOpenDriverRegistryKey restituisce STATUS_SUCCESS se la chiamata ha aperto correttamente un handle alla chiave del Registro di sistema richiesta.

Commenti

Il driver deve chiamare ZwClose per chiudere l'handle restituito da questa routine quando l'accesso non è più necessario.

Le chiavi del Registro di sistema aperte da questa routine sono non volatile.

Per effettuare il provisioning di chiavi e valori nella chiave del Registro di sistema immutable DriverRegKeyParameters , usare una direttiva AddReg da una sezione service-install-section per fare riferimento a una sezione add-registry che contiene voci con una radice reg di HKR e una sottochiave di Parameters.

I chiamanti di IoOpenDriverRegistryKey devono essere in esecuzione in IRQL = PASSIVE_LEVEL nel contesto di un thread di sistema.

Requisiti

Vedi anche

ZwClose

ACCESS_MASK

DRIVER_REGKEY_TYPE