Função RtlDeleteRegistryValue (wdm.h)

  • Artigo

A rotina RtlDeleteRegistryValue remove o nome de entrada especificado e os valores associados do registro ao longo do caminho relativo fornecido.

Sintaxe

NTSYSAPI NTSTATUS RtlDeleteRegistryValue(
  [in] ULONG  RelativeTo,
  [in] PCWSTR Path,
  [in] PCWSTR ValueName
);

Parâmetros

[in] RelativeTo

Especifica se Path é um caminho absoluto do Registro ou é relativo a um caminho de chave 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_HANDLE Especifica que o parâmetro Path é, na verdade, um identificador do Registro a ser usado. Esse valor é opcional.

[in] Path

Especifica o caminho do Registro de acordo com o valor RelativeTo . Se RTL_REGISTRY_HANDLE estiver definido, Path será um identificador a ser usado diretamente.

[in] ValueName

Ponteiro para o nome do valor a ser removido do registro.

Retornar valor

RtlDeleteRegistryValue retornará STATUS_SUCCESS se a entrada de valor tiver sido excluída.

Observe que, se RelativeTo estiver definido como RTL_REGISTRY_HANDLE, ocorrerá o seguinte:

  • No Windows 98/Me e Windows NT 4.0, a rotina fecha o identificador especificado antes de retornar.
  • No Windows 2000 e versões posteriores do Windows, a rotina deixa a alça aberta.

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
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport), IrqlRtlPassive(wdm)

Confira também

RtlCheckRegistryKey

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey