Fungsi RtlGetPersistedStateLocation (ntddk.h)

Mengambil lokasi yang dialihkan untuk SourceID yang ditentukan dari peta pengalihan.

Sintaks

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

Pengidentifikasi untuk mencari di peta pengalihan.

[_In_opt_] CustomValue

Opsional. Nilai yang akan diambil, jika berbeda dari nilai default.

[_In_opt_] DefaultPath

Pilihan. Jika entri untuk nilai SourceID tidak dapat ditemukan di peta, mengembalikan nilai ini.

[_In_] StateLocationType

Nilai jenis STATE_LOCATION_TYPE yang menunjukkan jenis Status untuk dicari; registri atau sistem file.

[_In_] TargetPath

Penunjuk ke string Unicode yang menerima nilai . Jika panggilan berhasil. String dihentikan null.

[_In_] BufferLengthIn

Ukuran string yang ditujukkan oleh TargetPath, dalam byte.

[_Out_opt_] BufferLengthOut

Pilihan. Jika ditentukan, mengembalikan jumlah byte yang ditulis ke buffer jika panggilan berhasil; jumlah byte yang diperlukan jika panggilan gagal dengan kode kesalahan STATUS_BUFFER_OVERFLOW.

Mengembalikan nilai

Mengembalikan nilai NTSTATUS yang menunjukkan keberhasilan kegagalan operasi. Jika tidak, mengembalikan nilai NTSTATUS yang sesuai.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1803
Header ntddk.h
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe

Lihat juga

STATE_LOCATION_TYPE