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值。

規格需求

另請參閱

STATE_LOCATION_TYPE