structure DSOP_INIT_INFO (objsel.h)

La structure DSOP_INIT_INFO contient les données requises pour initialiser une boîte de dialogue sélecteur d’objets. Cette structure est utilisée avec la méthode IDsObjectPicker ::Initialize .

Syntaxe

typedef struct _DSOP_INIT_INFO {
  ULONG                 cbSize;
  PCWSTR                pwzTargetComputer;
  ULONG                 cDsScopeInfos;
  PDSOP_SCOPE_INIT_INFO aDsScopeInfos;
  ULONG                 flOptions;
  ULONG                 cAttributesToFetch;
  PCWSTR                *apwzAttributeNames;
} DSOP_INIT_INFO, *PDSOP_INIT_INFO;

Membres

cbSize

Contient la taille, en octets, de la structure.

pwzTargetComputer

Pointeur vers une chaîne Unicode terminée par null qui contient le nom de l’ordinateur cible. La boîte de dialogue fonctionne comme si elle s’exécutait sur l’ordinateur cible, en utilisant l’ordinateur cible pour déterminer le domaine et l’entreprise joints. Si cette valeur est NULL, l’ordinateur cible est l’ordinateur local.

cDsScopeInfos

Spécifie le nombre d’éléments dans le tableau aDsScopeInfos .

aDsScopeInfos

Pointeur vers un tableau de structures DSOP_SCOPE_INIT_INFO qui décrivent les étendues à partir desquelles l’utilisateur peut sélectionner des objets. Ce membre ne peut pas avoir la valeur NULL et le tableau doit contenir au moins un élément, car le sélecteur d’objets ne peut pas fonctionner sans au moins une étendue.

flOptions

Indicateurs qui déterminent les options du sélecteur d’objets. Ce membre peut être égal à zéro ou à une combinaison d’un ou plusieurs des indicateurs suivants.

DSOP_FLAG_MULTISELECT (0x00000001)

Si cet indicateur est défini, l’utilisateur peut sélectionner plusieurs objets. Si cet indicateur n’est pas défini, l’utilisateur ne peut sélectionner qu’un seul objet.

DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)

Si cet indicateur est défini et que l’indicateur DSOP_SCOPE_TYPE_TARGET_COMPUTER est défini dans le tableau aDsScopeInfos , l’ordinateur cible est toujours inclus dans la liste déroulante Rechercher dans .

Si cet indicateur n’est pas défini et que l’ordinateur cible est un contrôleur de domaine de niveau supérieur ou inférieur, l’indicateur DSOP_SCOPE_TYPE_TARGET_COMPUTER est ignoré et l’ordinateur cible n’est pas inclus dans la liste déroulante Rechercher dans .

Pour gagner du temps pendant l’initialisation, cet indicateur doit être défini s’il est connu que l’ordinateur cible n’est pas un contrôleur de domaine. Toutefois, si l’ordinateur cible est un contrôleur de domaine, cet indicateur ne doit pas être défini, car il est préférable pour l’utilisateur de sélectionner des objets de domaine à partir de l’étendue du domaine plutôt que du contrôleur de domaine lui-même.

cAttributesToFetch

Contient le nombre d’éléments dans le tableau apwzAttributeNames . Ce membre peut être égal à zéro.

apwzAttributeNames

Pointeur vers un tableau de chaînes Unicode terminées par null qui contiennent les noms des attributs à récupérer pour chaque objet sélectionné. Si cAttributesToFetch est égal à zéro, ce membre est ignoré.

Configuration requise

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

Voir aussi

DSOP_SCOPE_INIT_INFO

Sélecteur d’objets directory

IDsObjectPicker ::Initialize