Fungsi LsaQueryTrustedDomainInfo (ntsecapi.h)

Artikel
03/15/2023

Fungsi LsaQueryTrustedDomainInfo mengambil informasi tentang domain tepercaya.

Sintaks

NTSTATUS LsaQueryTrustedDomainInfo(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PSID                      TrustedDomainSid,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

Parameter

[in] PolicyHandle

Handel ke objek Kebijakan pengendali domain yang memiliki hubungan kepercayaan dengan domain yang diidentifikasi oleh parameter TrustedDomainSid . Handel harus memiliki hak akses POLICY_VIEW_LOCAL_INFORMATION. Untuk informasi selengkapnya, lihat Membuka Penanganan Objek Kebijakan.

[in] TrustedDomainSid

Arahkan ke SID domain tepercaya untuk dikueri.

[in] InformationClass

Menentukan salah satu nilai berikut dari jenis enumerasi TRUSTED_INFORMATION_CLASS . Nilai menunjukkan jenis informasi yang diminta.

Nilai	Makna
TrustedDomainNameInformation	Mengambil nama domain tepercaya. Parameter Buffer menerima pointer ke struktur TRUSTED_DOMAIN_NAME_INFO .
TrustedPosixOffsetInformation	Mengambil nilai yang digunakan untuk menghasilkan pengidentifikasi pengguna dan grup Posix untuk domain tepercaya. Parameter Buffer menerima penunjuk ke struktur TRUSTED_POSIX_OFFSET_INFO .
TrustedPasswordInformation	Mengambil kata sandi untuk domain tepercaya. Parameter Buffer menerima pointer ke struktur TRUSTED_PASSWORD_INFO . Handel yang diteruskan dalam parameter PolicyHandle harus memiliki hak akses POLICY_GET_PRIVATE_INFORMATION.
TrustedDomainInformationEx	Mengambil informasi yang diperluas untuk domain tepercaya. Parameter Buffer menerima pointer ke struktur TRUSTED_DOMAIN_INFORMATION_EX .
TrustedDomainInformationBasic	Nilai ini tidak didukung.
TrustedDomainFullInformation	Mengambil informasi lengkap untuk domain tepercaya. Informasi ini mencakup informasi offset Posix, informasi autentikasi, dan informasi yang diperluas yang dikembalikan untuk nilai TrustedDomainInformationEx. Parameter Buffer menerima pointer ke struktur TRUSTED_DOMAIN_FULL_INFORMATION .

[out] Buffer

Penunjuk ke buffer yang menerima penunjuk ke struktur yang berisi informasi yang diminta. Jenis struktur tergantung pada nilai parameter InformationClass .

Setelah Anda selesai menggunakan informasi, bebaskan pointer yang dikembalikan dengan meneruskannya ke LsaFreeMemory.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan STATUS_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan nilai NTSTATUS yang menunjukkan kesalahan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Fungsi Kebijakan LSA.

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

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