Fungsi LsaRetrievePrivateData (ntsecapi.h)

Jangan gunakan fungsi data privat LSA untuk enkripsi dan dekripsi data generik. Sebagai gantinya, gunakan fungsi CryptProtectData dan CryptUnprotectData . Hanya gunakan fungsi data privat LSA saat perlu memanipulasi rahasia LSA seperti yang didokumenkan dalam Model Data Objek Rahasia

Sintaks

NTSTATUS LsaRetrievePrivateData(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING KeyName,
  [out] PLSA_UNICODE_STRING *PrivateData
);

Parameter

[in] PolicyHandle

Handel ke objek Policy . Handel harus memiliki hak akses POLICY_GET_PRIVATE_INFORMATION. Untuk informasi selengkapnya, lihat Membuka Penanganan Objek Kebijakan.

[in] KeyName

Penunjuk ke struktur LSA_UNICODE_STRING yang berisi nama kunci tempat data privat disimpan.

Untuk membuat objek khusus, tambahkan salah satu awalan berikut ke nama kunci.

Prefiks	Makna
L$	Untuk objek lokal.
G$	Untuk objek global.
M$	Untuk objek komputer.

 

Jika Anda tidak membuat salah satu jenis khusus ini, Anda tidak perlu menentukan awalan nama kunci. Untuk informasi selengkapnya, lihat Objek Data Privat.

[out] PrivateData

Penunjuk ke variabel yang menerima penunjuk ke struktur LSA_UNICODE_STRING yang berisi data privat.

Ketika Anda tidak lagi memerlukan informasi, teruskan pointer yang dikembalikan ke LsaFreeMemory.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan STATUS_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan nilai NTSTATUS , yang dapat menjadi nilai berikut atau salah satu Nilai Pengembalian Fungsi Kebijakan LSA.

Menampilkan kode	Deskripsi
STATUS_OBJECT_NAME_NOT_FOUND	Tidak ada data privat yang disimpan dengan nama yang ditentukan oleh parameter KeyName .

 

Anda dapat menggunakan fungsi LsaNtStatusToWinError untuk mengonversi nilai NTSTATUS ke kode kesalahan Windows.

Keterangan

Anda harus menjalankan proses ini "Sebagai Administrator" atau panggilan gagal dengan ERROR_ACCESS_DENIED.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	ntsecapi.h
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

LSA_UNICODE_STRING

LsaFreeMemory

LsaStorePrivateData