RtlGetPersistedStateLocation-Funktion (ntddk.h)
Ruft den umgeleiteten Speicherort für die angegebene SourceID aus der Umleitungszuordnung ab.
Syntax
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
);
Parameter
[_In_] SourceID
Der Bezeichner, nach dem in der Umleitungszuordnung gesucht werden soll.
[_In_opt_] CustomValue
Optional. Der abzurufende Wert, wenn er sich vom Standardwert unterscheidet.
[_In_opt_] DefaultPath
Optional. Wenn ein Eintrag für den SourceID-Wert in der Zuordnung nicht gefunden werden kann, gibt diesen Wert zurück.
[_In_] StateLocationType
Ein STATE_LOCATION_TYPE-Type-Wert, der den Typ des nachzuschlagenden Zustands angibt; Registrierung oder Dateisystem.
[_In_] TargetPath
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Wert empfängt. Wenn der Aufruf erfolgreich ist. Die Zeichenfolge ist null-beendet.
[_In_] BufferLengthIn
Die Größe der Zeichenfolge, auf die von TargetPath in Bytes verwiesen wird.
[_Out_opt_] BufferLengthOut
Optional. Wenn angegeben, gibt die Anzahl der Bytes zurück, die in den Puffer geschrieben wurden, falls der Aufruf erfolgreich ist. Anzahl der erforderlichen Bytes, wenn der Aufruf mit dem STATUS_BUFFER_OVERFLOW Fehlercode fehlschlägt.
Rückgabewert
Gibt einen NTSTATUS-Wert zurück, der den Erfolg des Fehlers des Vorgangs angibt. Andernfalls wird ein entsprechender NTSTATUS-Wert zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1803 |
| Kopfzeile | ntddk.h |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |