estructura DSOP_SCOPE_INIT_INFO (objsel.h)
La estructura DSOP_SCOPE_INIT_INFO describe uno o varios tipos de ámbito que tienen los mismos atributos. Un tipo de ámbito es un tipo de ubicación, por ejemplo, un dominio, un equipo o un catálogo global, desde el que el usuario puede seleccionar objetos. Esta estructura se usa con DSOP_INIT_INFO al llamar a IDsObjectPicker::Initialize.
Sintaxis
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;
Miembros
cbSize
Contiene el tamaño, en bytes, de la estructura.
flType
Marcas que indican los tipos de ámbito descritos por esta estructura. Puede combinar varios tipos de ámbito si todos los ámbitos especificados usan la misma configuración. Este miembro puede ser una combinación de las marcas siguientes.
DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x00000001)
Equipo especificado por el miembro pwzTargetComputer de la estructura DSOP_INIT_INFO .
Si el equipo de destino es un controlador de dominio de nivel superior o descendente, esta marca se omite a menos que la marca DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK esté establecida en el miembro flOptions de la estructura DSOP_INIT_INFO .
DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN (0x00000002)
Dominio de nivel superior al que está unido el equipo de destino. Si se establece esta marca, use el miembro pwzDcName para especificar el nombre de un controlador de dominio en el dominio unido.
DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x00000004)
Dominio de nivel descendente al que está unido el equipo de destino.
DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)
Todos los dominios de la empresa a los que pertenece el equipo de destino. Si se especifica el ámbito de DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN , el ámbito de DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN representa todos los dominios de la empresa, excepto el dominio unido.
DSOP_SCOPE_TYPE_GLOBAL_CATALOG (0x00000010)
Ámbito que contiene objetos de todos los dominios de la empresa. Una empresa solo puede contener dominios de nivel superior.
DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x00000020)
Todos los dominios de nivel superior externos a la empresa, pero de confianza por el dominio al que está unido el equipo de destino.
DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN (0x00000040)
Todos los dominios de nivel descendente externos a la empresa, pero son de confianza para el dominio al que está unido el equipo de destino.
DSOP_SCOPE_TYPE_WORKGROUP (0x00000080)
Grupo de trabajo al que está unido el equipo de destino. Solo se aplica si el equipo de destino no está unido a un dominio.
El único tipo de objeto que se puede seleccionar desde un grupo de trabajo es un equipo.
DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE (0x00000100)
Permite al usuario escribir un ámbito de nivel superior. Si no se especifica ninguno de los tipos DSOP_SCOPE_TYPE_USER_ENTERED_* , el cuadro de diálogo restringe al usuario a los ámbitos de la lista desplegable Buscar en .
DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)
Permite al usuario escribir un ámbito de nivel descendente.
flScope
Marcas que indican el formato usado para devolver ADsPath para los objetos seleccionados en este ámbito. El miembro flScope también puede indicar el ámbito inicial que se muestra en la lista desplegable Buscar en . Este miembro puede ser una combinación de las marcas siguientes.
Las rutas ldap y global catalog (GC) se pueden convertir en la sintaxis de WinNT ADsPath. Las rutas de acceso de GC se pueden convertir al formato LDAP. Los objetos WinNT que tienen un atributo objectSid se pueden convertir al formato LDAP si se especifican las marcas DSOP_SCOPE_FLAG_WANT_SID_PATH o DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP . Ninguna otra conversión es legal.
DSOP_SCOPE_FLAG_STARTING_SCOPE (0x00000001)
El ámbito descrito por esta estructura se selecciona inicialmente en la lista desplegable Buscar en . Solo un ámbito puede especificar esta marca. Si ningún ámbito especifica esta marca, el ámbito inicial es el primer ámbito creado correctamente en la matriz de ámbitos pasados al método IDsObjectPicker::Initialize .
DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)
Los ADsPath se convierten para usar el proveedor winNT. Para obtener más información, vea WinNT ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)
Los ADsPath se convierten para usar el proveedor LDAP. Para obtener más información, consulte LDAP ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_GC (0x00000008)
Los ADsPaths para los objetos seleccionados en este ámbito se convierten para usar el proveedor de GC.
DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)
Los ADsPaths que tienen un atributo objectSid se convierten en el formulario LDAP://< SID=x> , donde x representa los dígitos hexadecimales del valor del atributo objectSid.
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
Los ADsPaths para objetos SID conocidos de nivel descendente son una cadena vacía a menos que se especifique esta marca (por ejemplo; DSOP_DOWNLEVEL_FILTER_INTERACTIVE). Si se especifica esta marca, las rutas de acceso tienen el formulario
WinNT://NT propietario de authority/interactivo o WinNT://Creator.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)
Si el filtro de ámbito contiene usuarios, active la casilla Usuarios en el cuadro de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)
Si el filtro de ámbito contiene grupos, active la casilla Grupos en el cuadro de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)
Si el filtro de ámbito contiene equipos, active la casilla Equipos en el cuadro de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)
Si el filtro de ámbito contiene contactos, active la casilla Contactos en el cuadro de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)
Si el filtro de ámbito contiene cuentas de servicio, active las casillas Cuentas de servicio y Cuentas de servicio administradas de grupo en el cuadro de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x00000800)
Si el filtro de ámbito contiene objetos de configuración de contraseña, active la casilla Objetos de configuración de contraseña en el cuadro de diálogo.
FilterFlags
Contiene una estructura DSOP_FILTER_FLAGS que indica los tipos de objetos presentados al usuario para este ámbito o ámbitos.
pwzDcName
Puntero a una cadena Unicode terminada en null que contiene el nombre de un controlador de dominio del dominio al que está unido el equipo de destino. Este miembro solo se usa si el miembro flType contiene la marca DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN . Si no se establece esa marca, pwzDcName debe ser NULL.
Este miembro puede ser NULL incluso si se especifica la marca DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN , en cuyo caso, el cuadro de diálogo busca el controlador de dominio. Este miembro le permite asignar un nombre a un controlador de dominio específico en un dominio multimaestro. Por ejemplo, una aplicación administrativa podría realizar cambios en un controlador de dominio en un dominio multimaestro y, a continuación, abrir el cuadro de diálogo selector de objetos antes de que los cambios se hayan replicado en los demás controladores de dominio.
pwzADsPath
Reservados; debe ser NULL.
hr
Contiene un valor HRESULT que indica el estado del ámbito específico. Si el método IDsObjectPicker::Initialize crea correctamente el ámbito, o ámbitos, especificados por esta estructura, hr contiene S_OK. De lo contrario, hr contiene un código de error.
Si IDsObjectPicker::Initialize devuelve S_OK, los miembros hr de todas las estructuras de DSOP_SCOPE_INIT_INFO especificadas también contienen S_OK.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | objsel.h |