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_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

另請參閱

STATE_LOCATION_TYPE