estructura DSOP_INIT_INFO (objsel.h)
La estructura DSOP_INIT_INFO contiene los datos necesarios para inicializar un cuadro de diálogo del selector de objetos. Esta estructura se usa con el método IDsObjectPicker::Initialize .
Sintaxis
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;
Miembros
cbSize
Contiene el tamaño, en bytes, de la estructura.
pwzTargetComputer
Puntero a una cadena Unicode terminada en null que contiene el nombre del equipo de destino. El cuadro de diálogo funciona como si se ejecuta en el equipo de destino, mediante el equipo de destino para determinar el dominio unido y la empresa. Si este valor es NULL, el equipo de destino es el equipo local.
cDsScopeInfos
Especifica el número de elementos de la matriz aDsScopeInfos .
aDsScopeInfos
Puntero a una matriz de estructuras de DSOP_SCOPE_INIT_INFO que describen los ámbitos desde los que el usuario puede seleccionar objetos. Este miembro no puede ser NULL y la matriz debe contener al menos un elemento porque el selector de objetos no puede funcionar sin al menos un ámbito.
flOptions
Marcas que determinan las opciones del selector de objetos. Este miembro puede ser cero o una combinación de una o varias de las marcas siguientes.
DSOP_FLAG_MULTISELECT (0x00000001)
Si se establece esta marca, el usuario puede seleccionar varios objetos. Si no se establece esta marca, el usuario solo puede seleccionar un objeto.
DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)
Si se establece esta marca y la marca de DSOP_SCOPE_TYPE_TARGET_COMPUTER se establece en la matriz aDsScopeInfos , el equipo de destino siempre se incluye en la lista desplegable Buscar en .
Si no se establece esta marca y el equipo de destino es un controlador de dominio de nivel superior o de nivel descendente, se omite la marca de DSOP_SCOPE_TYPE_TARGET_COMPUTER y el equipo de destino no se incluye en la lista desplegable Buscar en .
Para ahorrar tiempo durante la inicialización, esta marca debe establecerse si se sabe que el equipo de destino no es un controlador de dominio. Sin embargo, si el equipo de destino es un controlador de dominio, esta marca no debe establecerse porque es mejor que el usuario seleccione objetos de dominio desde el ámbito de dominio en lugar de desde el propio controlador de dominio.
cAttributesToFetch
Contiene el número de elementos de la matriz apwzAttributeNames . Este miembro puede ser cero.
apwzAttributeNames
Puntero a una matriz de cadenas Unicode terminadas en null que contienen los nombres de los atributos que se van a recuperar para cada objeto seleccionado. Si cAttributesToFetch es cero, este miembro se omite.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | objsel.h |