Funzione RtlGetPersistedStateLocation (ntddk.h)

Articolo
02/07/2025

Recupera la posizione reindirizzata per l'ELEMENTO SourceID specificato dalla mappa di reindirizzamento.

Sintassi

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
);

Parametri

[_In_] SourceID

Identificatore da cercare nella mappa di reindirizzamento.

[_In_opt_] CustomValue

Opzionale. Valore da recuperare, se diverso dal valore predefinito.

[_In_opt_] DefaultPath

Opzionale. Se non è possibile trovare una voce per il valore sourceID nella mappa, restituisce questo valore.

[_In_] StateLocationType

Valore STATE_LOCATION_TYPE-type che indica il tipo di stato da cercare; Registro di sistema o file system.

[_In_] TargetPath

Puntatore a una stringa Unicode che riceve il valore. Se la chiamata ha esito positivo. La stringa è con terminazione Null.

[_In_] BufferLengthIn

Dimensioni della stringa a cui punta TargetPath, in byte.

[_Out_opt_] BufferLengthOut

Opzionale. Se specificato, restituisce il numero di byte scritti nel buffer nel caso in cui la chiamata ha esito positivo; numero di byte necessari se la chiamata ha esito negativo con il codice di errore STATUS_BUFFER_OVERFLOW.

Valore restituito

Restituisce un valore NTSTATUS che indica l'esito negativo dell'operazione. In caso contrario, restituisce un valore NTSTATUS appropriato .

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1803
intestazione	ntddk.h
libreria	NtosKrnl.lib
dll	NtosKrnl.exe

Vedere anche

STATE_LOCATION_TYPE

Condividi tramite