structure ADS_SEARCHPREF_INFO (iads.h)

Article
08/24/2023

La structure ADS_SEARCHPREF_INFO spécifie les préférences de requête.

Syntaxe

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

Membres

dwSearchPref

Contient l’une des valeurs d’énumération ADS_SEARCHPREF_ENUM qui spécifie l’option de recherche à définir.

vValue

Contient une structure ADSVALUE qui spécifie le type de données et la valeur de la préférence de recherche.

dwStatus

Reçoit l’une des valeurs d’énumération ADS_STATUSENUM qui indique le status de la préférence de recherche. La méthode IDirectorySearch::SetSearchPreference renseigne ce membre lorsqu’il est appelé.

Notes

Pour configurer une préférence de recherche, affectez les valeurs appropriées aux champs d’une structure ADS_SEARCHPREF_INFO passée au serveur. Le membre vValue de la structure ADS_SEARCHPREF_INFO est une structure ADSVALUE . Le tableau suivant répertorie les valeurs ADS_SEARCHPREF_ENUM , les valeurs correspondantes pour le membre dwType de la structure ADSVALUE et le membre ADSVALUE utilisé pour le type spécifié.

ADS_SEARCHPREF_ENUM Valeur	membre dwTyped’ADSVALUE	Membre ADSVALUE
ADS_SEARCHPREF_ASYNCHRONOUS	ADSTYPE_BOOLEAN	Booléen
ADS_SEARCHPREF_DEREF_ALIASES	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_SIZE_LIMIT	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_TIME_LIMIT	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_ATTRIBTYPES_ONLY	ADSTYPE_BOOLEAN	Booléen
ADS_SEARCHPREF_SEARCH_SCOPE	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_TIMEOUT	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_PAGESIZE	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_PAGED_TIME_LIMIT	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_CHASE_REFERRALS	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_SORT_ON	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_CACHE_RESULTS	ADSTYPE_BOOLEAN	Booléen
ADS_SEARCHPREF_DIRSYNC	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_TOMBSTONE	ADSTYPE_BOOLEAN	Booléen
ADS_SEARCHPREF_VLV	ADSTYPE_PROV_SPECIFIC	ProviderSpecific
ADS_SEARCHPREF_ATTRIBUTE_QUERY	ADSTYPE_CASE_IGNORE_STRING	CaseIgnoreString
ADS_SEARCHPREF_SECURITY_MASK	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_DIRSYNC_FLAG	ADSTYPE_INTEGER	Integer
ADS_SEARCHPREF_EXTENDED_DN	ADSTYPE_INTEGER	Integer

Pour plus d’informations et des exemples sur l’utilisation de la structure ADS_SEARCHPREF_INFO , consultez les discussions de la méthode IDirectorySearch::SetSearchPreference et de l’énumération ADS_SEARCHPREF_ENUM .