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 |