Funzione WdfRegistryRemoveKey (wdfregistry.h)

Articolo
02/29/2024

[Si applica a KMDF e UMDF]

Il metodo WdfRegistryRemoveKey rimuove la chiave del Registro di sistema associata a un oggetto della 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 per 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 relativa alle 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.

Commenti

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 la restituzione di WdfRegistryRemoveKey .

Anche se è 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 Uso del Registro di sistema nei driver Framework-Based.

Esempio

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);

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	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