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 niveau inférieur auquel l’ordinateur cible est joint.
DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)
Tous les domaines de l’entreprise auquel l’ordinateur cible appartient. 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, à l’exception du 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 niveau inférieur 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 qui peut ê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 Rechercher dans .
DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)
Permet à l’utilisateur d’entrer une étendue de niveau inférieur.
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 Rechercher dans . Ce membre peut être une combinaison des indicateurs suivants.
Les chemins LDAP et Global Catalog (GC) peuvent être convertis en syntaxe WinNT ADsPath. Les chemins d’accès 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 Regarder dans . 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 d’étendues passé à la méthode IDsObjectPicker ::Initialize .
DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)
Les ADsPaths sont convertis pour utiliser le fournisseur WinNT. Pour plus d’informations, consultez WinNT ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)
Les ADsPaths 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 ADsPaths ayant un attribut objectSid sont convertis sous la forme LDAP://< SID=x> où x représente les chiffres hexadécimaux de la valeur de l’attribut objectSid.
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
Les ADsPaths des objets SID connus de niveau inférieur 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 d’accès ont la forme
WinNT://NT AUTHORITY/Interactive ou WinNT://Creator propriétaire.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)
Si le filtre d’étendue contient des utilisateurs, sélectionnez la zone Utilisateurs case activée dans la boîte de dialogue.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)
Si le filtre d’étendue contient des groupes, sélectionnez la zone Groupes case activée dans la boîte de dialogue.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)
Si le filtre d’étendue contient des ordinateurs, sélectionnez la zone Ordinateurs case activée dans la boîte de dialogue.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)
Si le filtre d’étendue contient des contacts, sélectionnez la zone Contacts case activée dans la boîte de dialogue.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)
Si le filtre d’étendue contient des comptes de service, sélectionnez les zones Comptes de service et Comptes de service gérés de groupe case activée 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, sélectionnez la zone Objets de paramètre de mot de passe case activée 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 ou ces étendues.
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 avoir la valeur NULL.
Ce membre peut avoir la valeur 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 multimaître. Par exemple, une application administrative peut apporter des modifications sur un contrôleur de domaine dans un domaine multimaître, 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 avoir la valeur NULL.
hr
Contient une valeur HRESULT qui indique la status 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 des S_OK.
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 |