RtlGetPersistedStateLocation 函式 (ntddk.h)
從重新導向對應擷取指定SourceID的重新導向位置。
語法
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
);
參數
[_In_] SourceID
重新導向對應中要查閱的標識碼。
[_In_opt_] CustomValue
選擇性。 要擷取的值,如果與預設值不同。
[_In_opt_] DefaultPath
選擇性。 如果對應中找不到 SourceID 值的專案,則會傳回此值。
[_In_] StateLocationType
指出要查閱之 State 類型的 STATE_LOCATION_TYPE型別值;登錄或文件系統。
[_In_] TargetPath
接收值的 Unicode 字串指標。 如果呼叫成功,則為 。 字串是以 Null 結尾。
[_In_] BufferLengthIn
TargetPath 指向的字串大小,以位元組為單位。
[_Out_opt_] BufferLengthOut
選擇性。 如果指定,則會傳回寫入緩衝區的位元組數目,以防呼叫成功;如果呼叫因STATUS_BUFFER_OVERFLOW錯誤碼而失敗,則為所需的位元元組數。
傳回值
傳回NTSTATUS值,指出作業失敗成功。 否則會傳回適當的 NTSTATUS值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 1803) |
標頭 | ntddk.h |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |