Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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) |