Função RtlWriteRegistryValue (wdm.h)

Artigo
08/08/2023

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