estrutura ADS_SEARCHPREF_INFO (iads.h)

Artigo
08/24/2023

A estrutura ADS_SEARCHPREF_INFO especifica as preferências de consulta.

Sintaxe

typedef struct ads_searchpref_info {
  ADS_SEARCHPREF dwSearchPref;
  ADSVALUE       vValue;
  ADS_STATUS     dwStatus;
} ADS_SEARCHPREF_INFO, *PADS_SEARCHPREF_INFO, *LPADS_SEARCHPREF_INFO;

Membros

dwSearchPref

Contém um dos valores de enumeração ADS_SEARCHPREF_ENUM que especifica a opção de pesquisa a ser definida.

vValue

Contém uma estrutura ADSVALUE que especifica o tipo de dados e o valor da preferência de pesquisa.

dwStatus

Recebe um dos valores de enumeração ADS_STATUSENUM que indica o status da preferência de pesquisa. O método IDirectorySearch::SetSearchPreference preencherá esse membro quando ele for chamado.

Comentários

Para configurar uma preferência de pesquisa, atribua valores apropriados aos campos de uma estrutura ADS_SEARCHPREF_INFO passada para o servidor. O membro vValue da estrutura ADS_SEARCHPREF_INFO é uma estrutura ADSVALUE . A tabela a seguir lista os valores ADS_SEARCHPREF_ENUM , os valores correspondentes para o membro dwType da estrutura ADSVALUE e o membro ADSVALUE usado para o tipo especificado.

ADS_SEARCHPREF_ENUM Valor	membro dwType de ADSVALUE	Membro ADSVALUE
ADS_SEARCHPREF_ASYNCHRONOUS	ADSTYPE_BOOLEAN	Booliano
ADS_SEARCHPREF_DEREF_ALIASES	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_SIZE_LIMIT	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_TIME_LIMIT	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_ATTRIBTYPES_ONLY	ADSTYPE_BOOLEAN	Booliano
ADS_SEARCHPREF_SEARCH_SCOPE	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_TIMEOUT	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_PAGESIZE	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_PAGED_TIME_LIMIT	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_CHASE_REFERRALS	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_SORT_ON	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_CACHE_RESULTS	ADSTYPE_BOOLEAN	Booliano
ADS_SEARCHPREF_DIRSYNC	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_TOMBSTONE	ADSTYPE_BOOLEAN	Booliano
ADS_SEARCHPREF_VLV	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_ATTRIBUTE_QUERY	ADSTYPE_CASE_IGNORE_STRING	CaseIgnoreString
ADS_SEARCHPREF_SECURITY_MASK	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_DIRSYNC_FLAG	ADSTYPE_INTEGER	Inteiro
ADS_SEARCHPREF_EXTENDED_DN	ADSTYPE_INTEGER	Inteiro

Para obter mais informações e exemplos de como usar a estrutura ADS_SEARCHPREF_INFO , consulte as discussões do método IDirectorySearch::SetSearchPreference e a enumeração ADS_SEARCHPREF_ENUM .