Fungsi DsListSitesA (ntdsapi.h)

Artikel
11/20/2024

Fungsi DsListSites mencantumkan semua situs di forest perusahaan.

Sintaksis

NTDSAPI DWORD DsListSitesA(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTA *ppSites
);

Parameter

[in] hDs

Berisi handel layanan direktori yang diperoleh dari DSBind atau fungsi DSBindWithCred.

[out] ppSites

Penunjuk ke penunjuk ke struktur DS_NAME_RESULT yang menerima daftar situs di perusahaan. Nama situs dikembalikan dalam format nama khusus (DN). Struktur yang dikembalikan harus dibebaskan menggunakan fungsi DsFreeNameResult.

Mengembalikan nilai

Jika fungsi mengembalikan daftar situs, nilai yang dikembalikan adalah NO_ERROR. Jika fungsi gagal, nilai pengembalian dapat menjadi salah satu kode kesalahan berikut.

Komentar

Kesalahan konversi nama individual dilaporkan dalam struktur DS_NAME_RESULT yang dikembalikan.

Nota

Header ntdsapi.h mendefinisikan DsListSites sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista
server minimum yang didukung	Windows Server 2008
Platform Target	Windows
Header	ntdsapi.h
Pustaka	Ntdsapi.lib
DLL	Ntdsapi.dll

Lihat juga

DS_NAME_RESULT

Fungsi Pengendali Domain dan Manajemen Replikasi

DsFreeNameResult

Bagikan melalui