Fungsi LsaEnumerateTrustedDomainsEx (ntsecapi.h)

Artikel
08/25/2023

Fungsi LsaEnumerateTrustedDomainsEx mengembalikan informasi tentang domain yang dipercaya oleh sistem lokal. LsaEnumerateTrustedDomainsEx mengembalikan informasi hanya pada kepercayaan langsung. DsEnumerateDomainTrusts direkomendasikan untuk tujuan enumerasi kepercayaan yang lebih lengkap.

Sintaks

NTSTATUS LsaEnumerateTrustedDomainsEx(
  [in]  LSA_HANDLE              PolicyHandle,
  [in]  PLSA_ENUMERATION_HANDLE EnumerationContext,
  [out] PVOID                   *Buffer,
  [in]  ULONG                   PreferedMaximumLength,
  [out] PULONG                  CountReturned
);

Parameter

[in] PolicyHandle

Handel ke objek Policy . Panggilan ini memerlukan akses POLICY_VIEW_LOCAL_INFORMATION ke objek Policy . Untuk informasi selengkapnya, lihat Membuka Penanganan Objek Kebijakan.

[in] EnumerationContext

Penunjuk ke LSA_ENUMERATION_HANDLE yang dapat Anda gunakan untuk melakukan beberapa panggilan ke LsaEnumerateTrustedDomainsEx untuk mengambil semua informasi domain tepercaya. Untuk informasi selengkapnya, lihat Keterangan.

[out] Buffer

Pointer ke buffer yang menerima daftar struktur TRUSTED_DOMAIN_INFORMATION_EX yang berisi informasi tentang domain tepercaya yang dijumlahkan.

Aplikasi Anda harus membebaskan buffer ini ketika tidak lagi diperlukan dengan memanggil LsaFreeMemory.

[in] PreferedMaximumLength

Panjang maksimum yang disukai, dalam byte, dari data yang dikembalikan. Ini bukan batas atas yang sulit, tetapi berfungsi sebagai panduan. Karena konversi data antara sistem dengan ukuran data alami yang berbeda, jumlah aktual data yang dikembalikan mungkin lebih besar dari nilai ini.

[out] CountReturned

Penunjuk ke LONG yang menerima jumlah objek domain tepercaya yang dikembalikan.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan STATUS_SUCCESS.

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

Nilai	Deskripsi
STATUS_ACCESS_DENIED	Penelepon tidak memiliki akses yang sesuai untuk menyelesaikan operasi.
STATUS_NO_MORE_ENTRIES	Tidak ada entri lagi. Peringatan ini dikembalikan jika tidak ada objek yang dijumlahkan karena nilai EnumerationContext terlalu tinggi.

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

Keterangan

Mengambil semua informasi kepercayaan mungkin memerlukan lebih dari satu panggilan LsaEnumerateTrustedDomainsEx .

Untuk menggunakan parameter EnumerationContext untuk melakukan beberapa panggilan

Atur variabel yang ditujukkan oleh EnumerationContext ke nol.
Jika LsaEnumerateTrustedDomainsEx mengembalikan STATUS_SUCCESS atau STATUS_MORE_ENTRIES, panggil fungsi lagi, meneruskan nilai EnumerationContext yang dikembalikan oleh panggilan sebelumnya.
Enumerasi selesai ketika fungsi mengembalikan STATUS_NO_MORE_ENTRIES.

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_ENUMERATION_HANDLE

LsaFreeMemory

TRUSTED_DOMAIN_INFORMATION_EX

Bagikan melalui