Memproses Hasil Pencarian

Setelah panggilan pertama ke IDirectorySearch::GetFirstRow atau IDirectorySearch::GetNextRow, baik S_OK, S_ADS_NOMORE_ROWS, atau hasil kesalahan dikembalikan.

Jika nilai yang dikembalikan S_ADS_NOMORE_ROWS, tidak ada lagi objek yang cocok dengan filter yang ditemukan. Jika hasil kesalahan dikembalikan, kueri gagal. Dalam kedua kasus, Anda tidak diharuskan memproses baris dalam hasil karena tidak ada yang dikembalikan.

Jika S_OK dikembalikan, baris telah diambil. Anda dapat mengurai kolom berdasarkan nama menggunakan IDirectorySearch::GetColumn. Nama tersebut adalah lDAPDisplayName dari atribut di kolom . Kumpulan semua kolom ditentukan oleh parameter pAttributeNames dari metode IDirectorySearch::ExecuteSearch. Jika NULL ditentukan, kumpulan semua kolom adalah gabungan dari semua properti yang ditemukan untuk semua objek yang dikembalikan. Untuk membaca seluruh kumpulan kolom yang dikembalikan untuk objek, gunakan IDirectorySearch::GetNextColumnName untuk melakukan iterasi setiap kolom, dan gunakan nama kolom yang dikembalikan untuk memanggil IDirectorySearch::GetColumn.

Metode IDirectorySearch::GetColumn mengembalikan struktur ADS_SEARCH_COLUMN yang berisi nama atribut, jenis atribut, jumlah nilai, dan penunjuk ke array struktur ADSVALUE yang berisi nilai. Anda dapat mengulangi struktur ADSVALUE untuk membaca nilai properti yang dikembalikan oleh kolom. Anda harus membaca anggota struktur ADSVALUE yang sesuai berdasarkan ADSTYPE yang ditentukan oleh anggota dwADsType dari struktur ADS_SEARCH_COLUMN (atau anggota dwType dari struktur ADSVALUE). Misalnya, jika dwADsType ADSTYPE_INTEGER, Anda akan membaca anggota Bilangan Bulat dari setiap struktur ADSVALUE.

Untuk informasi selengkapnya dan contoh kode, lihat Contoh Kode untuk Mencari Pengguna.