Fonction RtlDeleteRegistryValue (wdm.h)
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) |