Compartilhar via


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

Confira também

RtlCheckRegistryKey

RtlCreateRegistryKey

RtlDeleteRegistryValue

RtlQueryRegistryValues

ZwCreateKey

ZwOpenKey

ZwSetValueKey