Función RtlGetPersistedStateLocation (ntddk.h)

Recupera la ubicación redirigida para el SourceID especificado desde el mapa de redireccionamiento.

Sintaxis

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

Identificador que se va a buscar en el mapa de redireccionamiento.

[_In_opt_] CustomValue

Opcional. Valor que se va a recuperar, si es diferente del valor predeterminado.

[_In_opt_] DefaultPath

Opcional. Si no se encuentra una entrada para el sourceID valor en el mapa, devuelve este valor.

[_In_] StateLocationType

Valor de tipo STATE_LOCATION_TYPEque indica el tipo de Estado que se va a buscar; registro o sistema de archivos.

[_In_] TargetPath

Puntero a una cadena Unicode que recibe el valor. Si la llamada se realiza correctamente. La cadena está terminada en null.

[_In_] BufferLengthIn

Tamaño de la cadena a la que apunta TargetPath, en bytes.

[_Out_opt_] BufferLengthOut

Opcional. Si se especifica, devuelve el número de bytes escritos en el búfer en caso de que la llamada sea correcta; número de bytes necesarios si se produce un error en la llamada con el código de error STATUS_BUFFER_OVERFLOW.

Valor devuelto

Devuelve un valor NTSTATUS que indica el éxito de error de la operación. De lo contrario, devuelve un valor NTSTATUS adecuado .

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1803
encabezado de	ntddk.h
biblioteca de	NtosKrnl.lib
DLL de	NtosKrnl.exe

Consulte también

STATE_LOCATION_TYPE