énumération ADS_DEREFENUM (iads.h)

Article
03/02/2024

L’énumération ADS_DEREFENUM spécifie le processus par lequel les alias sont déréférencés.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0020 {
  ADS_DEREF_NEVER = 0,
  ADS_DEREF_SEARCHING = 1,
  ADS_DEREF_FINDING = 2,
  ADS_DEREF_ALWAYS = 3
} ADS_DEREFENUM;

Constantes


`ADS_DEREF_NEVER` Valeur : 0 Ne déréférence pas les alias lors de la recherche ou de la localisation de l’objet de base de la recherche.
`ADS_DEREF_SEARCHING` Valeur : 1 Déréférence les alias lors de la recherche des subordonnées de l'objet de base, mais pas lors de la localisation de l'objet de base lui-même.
`ADS_DEREF_FINDING` Valeur : 2 Déréférence les alias lors de la localisation de l'objet de base de la recherche, mais pas lors de la recherche de ses subordonnées.
`ADS_DEREF_ALWAYS` Valeur : 3 Déréférencer les alias lors de la recherche de l'objet de base et de ses subordonnés.

Remarques

L’interface IDirectorySearch utilise ces constantes pour définir le comportement de déréférencement de l’alias. Si aucune option n’est spécifiée, la valeur par défaut du serveur est ADS_DEREF_NEVER.

Note Étant donné que VBScript ne peut pas lire les données d’une bibliothèque de types, les applications VBScript ne reconnaissent pas les constantes symboliques telles que définies ci-dessus. Utilisez plutôt les constantes numériques pour définir les indicateurs appropriés dans vos applications VBScript. Pour utiliser les constantes symboliques, comme une bonne pratique de programmation, déclarez explicitement les constantes, comme cela est fait ici.

Exemples

L’exemple de code suivant montre comment définir la préférence de recherche pour le déréférencement d’alias. m_pSearch fait référence à un pointeur vers un objet implémentant l’interface IDirectorySearch .

ADS_SEARCHPREF_INFO prefInfo[1];
HRESULT hr;
 
prefInfo[0].dwSearchPref   = ADS_SEARCHPREF_DEREF_ALIASES;
prefInfo[0].vValue.dwType  = ADSTYPE_INTEGER;
prefInfo[0].vValue.Integer = ADS_DEREF_ALWAYS;
hr = m_pSearch->SetSearchPreference(prefInfo, 1);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	iads.h

Voir aussi

Énumérations ADSI

IDirectorySearch

Partager via