Fonction RtlDeleteRegistryValue (wdm.h)

  • Article

La routine RtlDeleteRegistryValue supprime le nom d’entrée spécifié et les valeurs associées du Registre le long du chemin relatif donné.

Syntaxe

NTSYSAPI NTSTATUS RtlDeleteRegistryValue(
  [in] ULONG  RelativeTo,
  [in] PCWSTR Path,
  [in] PCWSTR ValueName
);

Paramètres

[in] RelativeTo

Spécifie si Path est un chemin d’accès absolu au Registre ou s’il est relatif à un chemin de clé prédéfini comme l’un des éléments suivants.

Valeur Signification
RTL_REGISTRY_ABSOLUTE Path est un chemin d’accès absolu au Registre.
RTL_REGISTRY_SERVICES Le chemin d’accès est relatif à \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL Le chemin d’accès est relatif à \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT Le chemin d’accès est relatif à \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP Le chemin d’accès est relatif à \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER Le chemin d’accès est relatif à \Registry\User\CurrentUser. (Pour un processus système, il s’agit de \Users\. Par défaut.)
RTL_REGISTRY_HANDLE Spécifie que le paramètre Path est en fait un handle de Registre à utiliser. Cette valeur est facultative.

[in] Path

Spécifie le chemin d’accès du Registre en fonction de la valeur RelativeTo . Si RTL_REGISTRY_HANDLE est défini, Path est un handle à utiliser directement.

[in] ValueName

Pointeur vers le nom de la valeur à supprimer du Registre.

Valeur retournée

RtlDeleteRegistryValue retourne STATUS_SUCCESS si l’entrée de valeur a été supprimée.

Notez que si RelativeTo est défini sur RTL_REGISTRY_HANDLE, les opérations suivantes se produisent :

  • Sur Windows 98/Me et Windows NT 4.0, la routine ferme le handle spécifié avant de retourner.
  • Sur Windows 2000 et versions ultérieures de Windows, la routine laisse le handle ouvert.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Règles de conformité DDI HwStorPortProhibitedDDIs(storport),IrqlRtlPassive(wdm)

Voir aussi

RtlCheckRegistryKey

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey