Fonction RtlGetPersistedStateLocation (ntddk.h)

Récupère l’emplacement redirigé pour le SourceID spécifié à partir de la carte 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 la carte 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 la carte, 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

facultatif. S’il est spécifié, retourne le nombre d’octets écrits dans la mémoire tampon en cas de réussite de l’appel ; nombre d’octets requis si l’appel échoue avec le code d’erreur STATUS_BUFFER_OVERFLOW.

Valeur retournée

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

Condition requise Valeur
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