Função RtlDeleteRegistryValue (wdm.h)
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) |