Przetwarzanie wyników wyszukiwania

Po pierwszym wywołaniu metody IDirectorySearch::GetFirstRow lub IDirectorySearch::GetNextRow, zostanie zwrócony jeden z następujących wyników: S_OK, S_ADS_NOMORE_ROWSlub wynik błędu.

Jeśli zwracana wartość jest S_ADS_NOMORE_ROWS, nie znaleziono więcej obiektów pasujących do filtru. Jeśli zostanie zwrócony wynik błędu, zapytanie nie powiodło się. W obu przypadkach nie jest wymagane przetwarzanie wierszy w wyniku, ponieważ nie zwrócono żadnych wyników.

Jeśli zostanie zwrócona S_OK, zostanie pobrany wiersz. Możesz analizować kolumny według nazwy używając IDirectorySearch::GetColumn. Nazwa to lDAPDisplayName atrybutu w kolumnie. Zestaw wszystkich kolumn został zdefiniowany przez parametr pAttributeNames metody IDirectorySearch::ExecuteSearch. Jeśli określono null, zestaw wszystkich kolumn jest unią wszystkich właściwości znalezionych dla wszystkich zwróconych obiektów. Aby odczytać cały zestaw kolumn zwróconych dla obiektu, użyj IDirectorySearch::GetNextColumnName do przechodzenia przez każdą kolumnę i użyj nazwy zwróconej kolumny do wyprowadzenia IDirectorySearch::GetColumn.

Metoda IDirectorySearch::GetColumn zwraca strukturę ADS_SEARCH_COLUMN zawierającą nazwę atrybutu, typ atrybutu, liczbę wartości i wskaźnik do tablicy ADSVALUE struktur zawierających wartości. Można iterować przez struktury ADSVALUE, aby odczytać wartości właściwości zwracanej przez kolumnę. Należy przeczytać odpowiedni członek struktury ADSVALUE na podstawie ADSTYPE określonego przez członka dwADsType elementu struktury ADS_SEARCH_COLUMN (lub członka dwType elementu struktury ADSVALUE). Jeśli na przykład dwADsType została ADSTYPE_INTEGER, odczytasz składową liczba całkowita każdej struktury ADSVALUE.

Aby uzyskać więcej informacji i przykładowy kod, zobacz Przykładowy kod do wyszukiwania użytkowników.