estructura ADS_SEARCHPREF_INFO (iads.h)

Artículo
03/14/2023

La estructura ADS_SEARCHPREF_INFO especifica las preferencias de consulta.

Sintaxis

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

Members

dwSearchPref

Contiene uno de los valores de enumeración ADS_SEARCHPREF_ENUM que especifica la opción de búsqueda que se va a establecer.

vValue

Contiene una estructura ADSVALUE que especifica el tipo de datos y el valor de la preferencia de búsqueda.

dwStatus

Recibe uno de los valores de enumeración ADS_STATUSENUM que indica el estado de la preferencia de búsqueda. El método IDirectorySearch::SetSearchPreference rellenará este miembro cuando se llame a él.

Comentarios

Para configurar una preferencia de búsqueda, asigne los valores adecuados a los campos de una estructura de ADS_SEARCHPREF_INFO que se pasa al servidor. El miembro vValue de la estructura ADS_SEARCHPREF_INFO es una estructura ADSVALUE . En la tabla siguiente se enumeran los valores de ADS_SEARCHPREF_ENUM , los valores correspondientes para el miembro dwType de la estructura ADSVALUE y el miembro ADSVALUE que se usa para el tipo especificado.

ADS_SEARCHPREF_ENUM Valor	miembro dwType de ADSVALUE	Miembro ADSVALUE
ADS_SEARCHPREF_ASYNCHRONOUS	ADSTYPE_BOOLEAN	Boolean
ADS_SEARCHPREF_DEREF_ALIASES	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_SIZE_LIMIT	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_TIME_LIMIT	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_ATTRIBTYPES_ONLY	ADSTYPE_BOOLEAN	Boolean
ADS_SEARCHPREF_SEARCH_SCOPE	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_TIMEOUT	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_PAGESIZE	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_PAGED_TIME_LIMIT	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_CHASE_REFERRALS	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_SORT_ON	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_CACHE_RESULTS	ADSTYPE_BOOLEAN	Boolean
ADS_SEARCHPREF_DIRSYNC	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_TOMBSTONE	ADSTYPE_BOOLEAN	Boolean
ADS_SEARCHPREF_VLV	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_ATTRIBUTE_QUERY	ADSTYPE_CASE_IGNORE_STRING	CaseIgnoreString
ADS_SEARCHPREF_SECURITY_MASK	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_DIRSYNC_FLAG	ADSTYPE_INTEGER	Entero
ADS_SEARCHPREF_EXTENDED_DN	ADSTYPE_INTEGER	Entero

Para obtener más información y ejemplos de cómo usar la estructura de ADS_SEARCHPREF_INFO , vea los debates del método IDirectorySearch::SetSearchPreference y la enumeración ADS_SEARCHPREF_ENUM .