Fungsi DsListRolesA (ntdsapi.h)

Artikel
11/20/2024

Fungsi DsListRoles mencantumkan peran yang dikenali oleh server.

Sintaksis

NTDSAPI DWORD DsListRolesA(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTA *ppRoles
);

Parameter

[in] hDs

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

[out] ppRoles

Penunjuk ke variabel yang menerima penunjuk ke struktur DS_NAME_RESULT yang berisi peran yang dikenal server. Struktur yang dikembalikan harus dibatalkan alokasinya menggunakan DsFreeNameResult.

Indeks array dalam struktur DS_NAME_RESULT menunjukkan data apa yang dimuat oleh setiap elemen array. Konstanta berikut dapat digunakan untuk menentukan indeks yang diinginkan untuk bagian data tertentu.

DS_ROLE_DOMAIN_OWNER

Server memiliki domain.

DS_ROLE_INFRASTRUCTURE_OWNER

Server memiliki infrastruktur.

DS_ROLE_PDC_OWNER

Server memiliki PDC.

DS_ROLE_RID_OWNER

Server memiliki RID.

DS_ROLE_SCHEMA_OWNER

Server memiliki skema.

Mengembalikan nilai

Jika fungsi mengembalikan daftar peran, nilai yang dikembalikan NO_ERROR.

Jika fungsi gagal, nilai pengembalian dapat menjadi salah satu kode kesalahan berikut.

Kesalahan konversi nama individual dilaporkan dalam struktur DS_NAME_RESULT yang dikembalikan.

Komentar

Nota

Header ntdsapi.h mendefinisikan DsListRoles 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