Fungsi DsBrowseForContainerA (dsclient.h)

Fungsi DsBrowseForContainer menampilkan kotak dialog yang digunakan untuk menelusuri objek kontainer di Active Directory Domain Services.

Sintaks

int DsBrowseForContainerA(
  [in] PDSBROWSEINFOA pInfo
);

Parameter

[in] pInfo

Penunjuk ke struktur DSBROWSEINFO yang berisi data tentang menginisialisasi dialog browser kontainer dan menerima data tentang objek yang dipilih.

Nilai kembali

Fungsi mengembalikan salah satu nilai berikut.

Keterangan

Kotak dialog menampilkan pemilih kontainer yang diisi dengan kontainer dari akar tertentu atau yang menggunakan domain tepercaya. Jika menggunakan domain tepercaya, ia dapat menggunakan domain tempat pengguna saat ini masuk, atau dapat menggunakan domain alternatif yang ditentukan oleh aplikasi menggunakan anggota pszRoot dari struktur DSBROWSEINFO . Jika pengguna mengklik tombol tekan OK atau mengklik dua kali objek, IDOK dikembalikan dan pszPath berisi ADsPath dari objek yang dipilih. Jika pengguna membatalkan kotak dialog, DsBrowseForContainer mengembalikan IDCANCEL.

Anggota pszRoot berisi ADsPath, yang memerlukan formulir berikut.

LDAP://fabrikam.com/CN=Users,DC=Fabrikam,DC=com

DsBrowseForContainer menggunakan jalur ini sebagai akar pohon. Anggota pszRoot juga dapat digunakan untuk menentukan domain yang memiliki kepercayaan dengan domain tempat pengguna masuk, sehingga pengguna dapat menelusuri kontainer Pengguna dari domain alternatif. Jika anggota pszPath berisi jalur, dialog akan menavigasi dari pszRoot melalui kontainer hingga mencapai objek yang ditentukan oleh pszPath.

Fungsi DsBrowseForContainer mendukung fungsi panggilan balik seperti yang ditentukan dalam struktur DSBROWSEINFO . Fungsi panggilan balik dapat digunakan untuk memfilter, memodifikasi, atau memperbarui tampilan berdasarkan perubahan pilihan, dan sebagainya. Untuk informasi selengkapnya, lihat BFFCallBack.

Penting Dimulai dengan Windows Server 2003, versi ANSI dari fungsi ini (DsBrowseForContainerA) tidak diimplementasikan dan selalu mengembalikan -1.

 

Contoh

Contoh kode berikut memilih kontainer di domain tempat pengguna masuk. Tampilan juga menampilkan semua domain tepercaya.

void PickContainer(void)
{
    DSBROWSEINFOW dsbi = { 0 };
    WCHAR wszResult[MAX_PATH];
 
    dsbi.cbStruct = sizeof(dsbi);
    dsbi.pszCaption = L"The container picker";
    dsbi.pszTitle = L"Pick a container for this example.";
    dsbi.pszPath = wszResult;
    dsbi.cchPath = MAX_PATH;
    dsbi.dwFlags = DSBI_ENTIREDIRECTORY;

    int nReturn = DsBrowseForContainerW(&dsbi);
 
    if ( IDOK == nReturn )
    {
        // wszResult contains the resulting path
    }
}

Catatan

Header dsclient.h mendefinisikan DsBrowseForContainer sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	dsclient.h
Pustaka	Dsuiext.lib
DLL	Dsuiext.dll

Lihat juga

BFFCallBack

DSBROWSEINFO