Função RtlWriteRegistryValue (wdm.h)
A rotina RtlWriteRegistryValue grava dados fornecidos pelo chamador no registro ao longo do caminho relativo especificado no nome do valor fornecido.
Sintaxe
NTSYSAPI NTSTATUS RtlWriteRegistryValue(
[in] ULONG RelativeTo,
[in] PCWSTR Path,
[in] PCWSTR ValueName,
[in] ULONG ValueType,
[in, optional] PVOID ValueData,
[in] ULONG ValueLength
);
Parâmetros
[in] RelativeTo
Especifica se Path é um caminho absoluto do Registro ou se é relativo a um caminho predefinido como um dos seguintes.
| Valor | Significado |
|---|---|
| RTL_REGISTRY_ABSOLUTE | Path é um caminho absoluto do Registro. |
| RTL_REGISTRY_SERVICES | O caminho é relativo a \Registry\Machine\System\CurrentControlSet\Services. |
| RTL_REGISTRY_CONTROL | O caminho é relativo a \Registry\Machine\System\CurrentControlSet\Control. |
| RTL_REGISTRY_WINDOWS_NT | O caminho é relativo a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion. |
| RTL_REGISTRY_DEVICEMAP | O caminho é relativo a \Registry\Machine\Hardware\DeviceMap. |
| RTL_REGISTRY_USER | O caminho é relativo a \Registry\User\CurrentUser. (Para um processo do sistema, isso é \Users\. Padrão.) |
| RTL_REGISTRY_OPTIONAL | Especifica que a chave referenciada por esse parâmetro e o parâmetro Path são opcionais. |
| RTL_REGISTRY_HANDLE | Especifica que o parâmetro Path é, na verdade, um identificador do Registro a ser usado. Esse valor é opcional. |
[in] Path
Ponteiro para um caminho absoluto do Registro ou um caminho relativo ao local conhecido especificado pelo parâmetro RelativeTo . Se o sinalizador RTL_REGISTRY_HANDLE for especificado, esse parâmetro será um identificador do Registro para que uma chave já aberta seja usada diretamente.
[in] ValueName
Ponteiro para o nome de uma subchave ou entrada de valor a ser gravada no registro.
[in] ValueType
Especifica um valor REG_XXX que determina o tipo do parâmetro ValueName . Para obter uma lista dos valores possíveis, consulte o parâmetro Type de ZwSetValueKey.
[in, optional] ValueData
Ponteiro para o nome de uma subchave ou valores para que suas entradas de valor (ou ambas) sejam gravadas no registro.
[in] ValueLength
Especifica o número de bytes de ValueData a serem gravados no registro.
Retornar valor
RtlWriteRegistryValue retorna o status da operação, STATUS_SUCCESS ou um erro status.
Comentários
Se a chave especificada não existir, a rotina tentará criar a chave. Para que essa tentativa seja bem-sucedida, a nova chave deve ser uma subchave direta da chave que é referenciada pelo parâmetro Path e a chave à qual Path se refere deve ter sido aberta para acesso KEY_CREATE_SUB_KEY.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |