structure DSOP_SCOPE_INIT_INFO (objsel.h)
La structure DSOP_SCOPE_INIT_INFO décrit un ou plusieurs types d’étendue qui ont les mêmes attributs. Un type d’étendue est un type d’emplacement, par exemple un domaine, un ordinateur ou un catalogue global, à partir duquel l’utilisateur peut sélectionner des objets. Cette structure est utilisée avec DSOP_INIT_INFO lors de l’appel d’IDsObjectPicker::Initialize.
Syntaxe
typedef struct _DSOP_SCOPE_INIT_INFO {
ULONG cbSize;
ULONG flType;
ULONG flScope;
DSOP_FILTER_FLAGS FilterFlags;
PCWSTR pwzDcName;
PCWSTR pwzADsPath;
HRESULT hr;
} DSOP_SCOPE_INIT_INFO, *PDSOP_SCOPE_INIT_INFO;
Membres
cbSize
Contient la taille, en octets, de la structure.
flType
Indicateurs qui indiquent les types d’étendue décrits par cette structure. Vous pouvez combiner plusieurs types d’étendue si toutes les étendues spécifiées utilisent les mêmes paramètres. Ce membre peut être une combinaison des indicateurs suivants.
DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x00000001)
Ordinateur spécifié par le membre pwzTargetComputer de la structure DSOP_INIT_INFO .
Si l’ordinateur cible est un contrôleur de domaine de niveau supérieur ou inférieur, cet indicateur est ignoré, sauf si l’indicateur DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK est défini dans le membre flOptions de la structure DSOP_INIT_INFO .
DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN (0x00000002)
Domaine de niveau supérieur auquel l’ordinateur cible est joint. Si cet indicateur est défini, utilisez le membre pwzDcName pour spécifier le nom d’un contrôleur de domaine dans le domaine joint.
DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x00000004)
Domaine de bas niveau auquel l’ordinateur cible est joint.
DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)
Tous les domaines de l’entreprise auxquels appartient l’ordinateur cible. Si l’étendue DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN est spécifiée, l’étendue DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN représente tous les domaines de l’entreprise, sauf le domaine joint.
DSOP_SCOPE_TYPE_GLOBAL_CATALOG (0x00000010)
Étendue qui contient des objets de tous les domaines de l’entreprise. Une entreprise ne peut contenir que des domaines de niveau supérieur.
DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x00000020)
Tous les domaines de niveau supérieur externes à l’entreprise, mais approuvés par le domaine auquel l’ordinateur cible est joint.
DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN (0x00000040)
Tous les domaines de bas niveau externes à l’entreprise, mais approuvés par le domaine auquel l’ordinateur cible est joint.
DSOP_SCOPE_TYPE_WORKGROUP (0x00000080)
Groupe de travail auquel l’ordinateur cible est joint. S’applique uniquement si l’ordinateur cible n’est pas joint à un domaine.
Le seul type d’objet pouvant être sélectionné à partir d’un groupe de travail est un ordinateur.
DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE (0x00000100)
Permet à l’utilisateur d’entrer une étendue de niveau supérieur. Si aucun des types DSOP_SCOPE_TYPE_USER_ENTERED_* n’est spécifié, la boîte de dialogue limite l’utilisateur aux étendues de la liste déroulante Look in .
DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)
Permet à l’utilisateur d’entrer une étendue de bas niveau.
flScope
Indicateurs qui indiquent le format utilisé pour renvoyer ADsPath pour les objets sélectionnés dans cette étendue. Le membre flScope peut également indiquer l’étendue initiale affichée dans la liste déroulante Look in . Ce membre peut être une combinaison des indicateurs suivants.
Les chemins LDAP et GC (Global Catalog) peuvent être convertis en syntaxe ADsPath WinNT. Les chemins GC peuvent être convertis au format LDAP. Les objets WinNT ayant un attribut objectSid peuvent être convertis au format LDAP si vous spécifiez les indicateurs DSOP_SCOPE_FLAG_WANT_SID_PATH ou DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP . Aucune autre conversion n’est légale.
DSOP_SCOPE_FLAG_STARTING_SCOPE (0x00000001)
L’étendue décrite par cette structure est initialement sélectionnée dans la liste déroulante Look in . Une seule étendue peut spécifier cet indicateur. Si aucune étendue ne spécifie cet indicateur, l’étendue initiale est la première étendue créée avec succès dans le tableau des étendues passées à la méthode IDsObjectPicker::Initialize .
DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)
Les ADsPath sont convertis pour utiliser le fournisseur WinNT. Pour plus d’informations, consultez WinNT ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)
Les ADsPath sont convertis pour utiliser le fournisseur LDAP. Pour plus d’informations, consultez LDAP ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_GC (0x00000008)
Les ADsPaths pour les objets sélectionnés dans cette étendue sont convertis pour utiliser le fournisseur GC.
DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)
Les ADsPath ayant un attribut objectSid sont convertis en forme LDAP://< SID=x où x> représente les chiffres hexadécimaux de la valeur d’attribut objectSid.
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
Les ADsPaths pour les objets SID de bas niveau connus sont une chaîne vide, sauf si cet indicateur est spécifié (par exemple; DSOP_DOWNLEVEL_FILTER_INTERACTIVE). Si cet indicateur est spécifié, les chemins ont le formulaire
WinNT://NT propriétaire d’AUTHORITY/Interactive ou WinNT://Creator.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)
Si le filtre d’étendue contient des utilisateurs, cochez la case Utilisateurs dans la boîte de dialogue.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)
Si le filtre d’étendue contient des groupes, cochez la case Groupes dans la boîte de dialogue.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)
Si le filtre d’étendue contient des ordinateurs, cochez la case Ordinateurs dans la boîte de dialogue.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)
Si le filtre d’étendue contient des contacts, cochez la case Contacts dans la boîte de dialogue.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)
Si le filtre d’étendue contient des comptes de service, activez les cases à cocher Comptes de service et comptes de service managés de groupe dans la boîte de dialogue.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x00000800)
Si le filtre d’étendue contient des objets de paramètre de mot de passe, activez la case à cocher Objets de paramètre de mot de passe dans la boîte de dialogue.
FilterFlags
Contient une structure DSOP_FILTER_FLAGS qui indique les types d’objets présentés à l’utilisateur pour cette étendue ou étendue.
pwzDcName
Pointeur vers une chaîne Unicode terminée par null qui contient le nom d’un contrôleur de domaine du domaine auquel l’ordinateur cible est joint. Ce membre est utilisé uniquement si le membre flType contient l’indicateur DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN . Si cet indicateur n’est pas défini, pwzDcName doit être NULL.
Ce membre peut être NULL même si l’indicateur DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN est spécifié, auquel cas, la boîte de dialogue recherche le contrôleur de domaine. Ce membre vous permet de nommer un contrôleur de domaine spécifique dans un domaine multimaster. Par exemple, une application administrative peut apporter des modifications sur un contrôleur de domaine dans un domaine multimaster, puis ouvrir la boîte de dialogue sélecteur d’objets avant que les modifications aient été répliquées sur les autres contrôleurs de domaine.
pwzADsPath
Réservés au; doit être NULL.
hr
Contient une valeur HRESULT qui indique l’état de l’étendue spécifique. Si la méthode IDsObjectPicker::Initialize crée correctement l’étendue ou les étendues, spécifiées par cette structure, hr contient S_OK. Sinon, hr contient un code d’erreur.
Si IDsObjectPicker::Initialize retourne S_OK, les membres hr de toutes les structures DSOP_SCOPE_INIT_INFO spécifiées contiennent également S_OK.
Configuration requise
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| En-tête | objsel.h |