RtlGetPersistedStateLocation, fonction (ntddk.h)

Récupère l’emplacement redirigé pour le SourceID spécifié à partir du mappage de redirection.

Syntaxe

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

Paramètres

[_In_] SourceID

Identificateur à rechercher dans le mappage de redirection.

[_In_opt_] CustomValue

facultatif. Valeur à récupérer, si elle est différente de la valeur par défaut.

[_In_opt_] DefaultPath

facultatif. Si une entrée pour la valeur SourceID est introuvable dans le mappage, retourne cette valeur.

[_In_] StateLocationType

Valeur de type STATE_LOCATION_TYPE qui indique le type d’état à rechercher ; registre ou système de fichiers.

[_In_] TargetPath

Pointeur vers une chaîne Unicode qui reçoit la valeur. Si l’appel réussit. La chaîne est terminée par null.

[_In_] BufferLengthIn

Taille de la chaîne pointée par TargetPath, en octets.

[_Out_opt_] BufferLengthOut

Optionnel. S’il est spécifié, retourne le nombre d’octets écrits dans la mémoire tampon au cas où l’appel réussit ; nombre d’octets requis si l’appel échoue avec le code d’erreur STATUS_BUFFER_OVERFLOW.

Valeur de retour

Retourne une valeur NTSTATUS qui indique la réussite de l’échec de l’opération. Sinon, retourne une valeur NTSTATUS appropriée.

Configuration requise

   
Client minimal pris en charge Windows 10 version 1803
En-tête ntddk.h
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe

Voir aussi

STATE_LOCATION_TYPE