Funzione WdfRegistryRemoveKey (wdfregistry.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfRegistryRemoveKey rimuove la chiave del Registro di sistema associata a un oggetto chiave del Registro di sistema del framework specificato e quindi elimina l'oggetto chiave del Registro di sistema.

Sintassi

NTSTATUS WdfRegistryRemoveKey(
  [in] WDFKEY Key
);

Parametri

[in] Key

Handle di un oggetto chiave del Registro di sistema che rappresenta una chiave del Registro di sistema aperta.

Valore restituito

WdfRegistryRemoveKey restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, il metodo potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_INVALID_DEVICE_REQUEST	WdfRegistryRemoveKey non è stato chiamato in IRQL = PASSIVE_LEVEL.
STATUS_ACCESS_DENIED	Il driver non ha aperto la chiave del Registro di sistema con accesso all'eliminazione.
STATUS_NOT_IMPLEMENTED	Vedere la sezione Osservazioni.

Questo metodo potrebbe anche restituire altri valori NTSTATUS .

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Osservazioni

Nota

Prima di chiamare WdfRegistryRemoveKey, assicurarsi che tutte le chiavi e i valori nella chiave specificata siano stati eliminati. Eliminare prima ogni sottochiave, a partire dalle chiavi foglia e procedere in alto.

nota

Da un driver KMDF, non chiamare WdfRegistryRemoveKey e quindi WdfRegistryClose sulla stessa chiave. WDFKEY non è più valido dopo WdfRegistryRemoveKey.

Sebbene sia legale che un driver UMDF chiami WdfRegistryRemoveKey, la chiamata restituisce sempre STATUS_NOT_IMPLEMENTED. Per eliminare l'oggetto WDFKEY, un driver UMDF deve invece chiamare WdfRegistryClose.

Per altre informazioni sugli oggetti chiave del Registro di sistema, vedere Using the Registry in Framework-Based Drivers.

Esempi

Nell'esempio di codice seguente viene rimossa una chiave del Registro di sistema ed eliminato l'oggetto chiave del Registro di sistema.

NTSTATUS  status;

status = WdfRegistryRemoveKey(Key);

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfregistry.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Condividi tramite