Share via


Retornando apenas nomes de atributo com IDirectorySearch

Você pode executar uma pesquisa para determinar que tipo de dados está disponível para um objeto específico. Nesse caso, você está interessado apenas nos nomes dos atributos, não nos valores de atributo do objeto. A opção ADS_SEARCHPREF_ATTRIBTYPES_ONLY faz com que o servidor retorne apenas os nomes de atributo e não os valores de atributo. No entanto, o conjunto de resultados inclui apenas os atributos que têm valores atribuídos. Por exemplo, considere um objeto com os seguintes atributos:

name = Jeff
sn = Smith
department = Empty
phone = 206-555-0111

Quando a opção ADS_SEARCHPREF_ATTRIBTYPES_ONLY é definida, o conjunto de resultados inclui:

name
sn
department
phone

O padrão é que os valores de atributo e os nomes sejam retornados.

Para recuperar apenas nomes de atributos, defina uma opção de pesquisa ADS_SEARCHPREF_ATTRIBTYPES_ONLY com um valor ADSTYPE_BOOLEAN TRUE na matriz ADS_SEARCHPREF_INFOpassada para o método IDirectorySearch::SetSearchPreference .

O exemplo de código a seguir mostra como recuperar nomes de atributo somente.

ADS_SEARCHPREF_INFO SearchPref;
SearchPref.dwSearchPref = ADS_SEARCHPREF_ATTRIBTYPES_ONLY;
SearchPref.vValue.dwType = ADSTYPE_BOOLEAN;
SearchPref.vValue.Boolean = TRUE;

Para obter mais informações e um exemplo de código que mostra como usar a opção de pesquisa ADS_SEARCHPREF_ATTRIBTYPES_ONLY, consulte Código de exemplo para pesquisar atributos.