Fungsi LsaOpenTrustedDomainByName (ntsecapi.h)

  • Artikel

Fungsi LsaOpenTrustedDomainByName membuka handel kebijakan LSA dari domain tepercaya jarak jauh. Anda dapat meneruskan handel ini ke panggilan fungsi LSA untuk mengatur atau mengkueri kebijakan LSA komputer jarak jauh.

Sintaks

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

Parameter

[in] PolicyHandle

Handel ke objek Policy . Ini adalah handel kebijakan komputer lokal. Untuk informasi selengkapnya, lihat Membuka Penanganan Objek Kebijakan.

[in] TrustedDomainName

Nama domain tepercaya. Nama ini bisa berupa nama datar, atau nama domain Sistem Nama Domain (DNS).

[in] DesiredAccess

Struktur ACCESS_MASK yang menentukan izin akses yang diminta pada objek domain tepercaya jarak jauh.

[out] TrustedDomainHandle

Pointer yang menerima alamat penanganan kebijakan LSA dari domain tepercaya jarak jauh. Anda dapat meneruskan handel ini ke panggilan fungsi LSA untuk mengkueri dan mengelola kebijakan LSA komputer jarak jauh.

Ketika aplikasi Anda tidak lagi membutuhkan handel ini, aplikasi harus memanggil LsaClose untuk menghapus handel.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan STATUS_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah 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_OBJECT_NAME_NOT_FOUND
 Tidak ada objek Domain Tepercaya dalam Database LSA sistem target yang memiliki nama yang ditentukan.
 

Anda dapat menggunakan fungsi LsaNtStatusToWinError untuk mengonversi kode 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

Lihat juga

LsaClose