Função RtlGetPersistedStateLocation (ntddk.h)
Recupera o local redirecionado para o SourceID especificado do mapa de redirecionamento.
Sintaxe
NTSYSAPI NTSTATUS RtlGetPersistedStateLocation(
[_In_] PCWSTR SourceID,
[_In_opt_] PCWSTR CustomValue,
[_In_opt_] PCWSTR DefaultPath,
[_In_] STATE_LOCATION_TYPE StateLocationType,
[_In_] PWCHAR TargetPath,
[_In_] ULONG BufferLengthIn,
[_Out_opt_] PULONG BufferLengthOut
);
Parâmetros
[_In_] SourceID
O identificador a ser pesquisado no mapa de redirecionamento.
[_In_opt_] CustomValue
Opcional. O valor a ser recuperado, se for diferente do valor padrão.
[_In_opt_] DefaultPath
Opcional. Se uma entrada para o valor SourceID não puder ser encontrada no mapa, retornará esse valor.
[_In_] StateLocationType
Um valor de tipo STATE_LOCATION_TYPE que indica o tipo de Estado a ser pesquisado; registro ou sistema de arquivos.
[_In_] TargetPath
Um ponteiro para uma cadeia de caracteres Unicode que recebe o valor. Se a chamada for bem-sucedida. A cadeia de caracteres é terminada em nulo.
[_In_] BufferLengthIn
O tamanho da cadeia de caracteres apontada por TargetPath, em bytes.
[_Out_opt_] BufferLengthOut
Opcional. Se especificado, retorna o número de bytes gravados no buffer caso a chamada seja bem-sucedida; número de bytes necessários se a chamada falhar com o código de erro STATUS_BUFFER_OVERFLOW.
Retornar valor
Retorna um valor NTSTATUS que indica o sucesso da falha da operação. Caso contrário, retornará um valor NTSTATUS apropriado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1803 |
| Cabeçalho | ntddk.h |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |