Fonction RtlWriteRegistryValue (wdm.h)
La routine RtlWriteRegistryValue écrit les données fournies par l’appelant dans le registre le long du chemin relatif spécifié au nom de la valeur donnée.
Syntaxe
NTSYSAPI NTSTATUS RtlWriteRegistryValue(
[in] ULONG RelativeTo,
[in] PCWSTR Path,
[in] PCWSTR ValueName,
[in] ULONG ValueType,
[in, optional] PVOID ValueData,
[in] ULONG ValueLength
);
Paramètres
[in] RelativeTo
Spécifie si path est un chemin de Registre absolu ou est relatif à un chemin prédéfini comme suit.
| 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_OPTIONAL | Spécifie que la clé référencée par ce paramètre et le paramètre Path sont facultatifs. |
| RTL_REGISTRY_HANDLE | Spécifie que le paramètre Path est en fait un handle de Registre à utiliser. Cette valeur est facultative. |
[in] Path
Pointeur vers un chemin de Registre absolu ou un chemin relatif à l’emplacement connu spécifié par le paramètre RelativeTo . Si l’indicateur RTL_REGISTRY_HANDLE est spécifié, ce paramètre est un handle de Registre pour une clé déjà ouverte à utiliser directement.
[in] ValueName
Pointeur vers le nom d’une sous-clé ou d’une entrée de valeur à écrire dans le Registre.
[in] ValueType
Spécifie une valeur REG_XXX qui détermine le type du paramètre ValueName . Pour obtenir la liste des valeurs possibles, consultez le paramètre Type de ZwSetValueKey.
[in, optional] ValueData
Pointeur vers le nom d’une sous-clé ou des valeurs pour ses entrées de valeur (ou les deux) à écrire dans le Registre.
[in] ValueLength
Spécifie le nombre d’octets de ValueData à écrire dans le Registre.
Valeur retournée
RtlWriteRegistryValue retourne le status de l’opération, soit STATUS_SUCCESS, soit une erreur status.
Remarques
Si la clé spécifiée n’existe pas, la routine tente de créer la clé. Pour que cette tentative aboutisse, la nouvelle clé doit être une sous-clé directe de la clé référencée par le paramètre Path , et la clé à laquelle path fait référence doit avoir été ouverte pour l’accès KEY_CREATE_SUB_KEY.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Universal |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |