estrutura DSOP_INIT_INFO (objsel.h)
A estrutura DSOP_INIT_INFO contém os dados necessários para inicializar uma caixa de diálogo do seletor de objetos. Essa estrutura é usada com o método IDsObjectPicker::Initialize .
Sintaxe
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;
Membros
cbSize
Contém o tamanho, em bytes, da estrutura .
pwzTargetComputer
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do computador de destino. A caixa de diálogo funciona como se estivesse em execução no computador de destino, usando o computador de destino para determinar o domínio ingressado e a empresa. Se esse valor for NULL, o computador de destino será o computador local.
cDsScopeInfos
Especifica o número de elementos na matriz aDsScopeInfos .
aDsScopeInfos
Ponteiro para uma matriz de estruturas DSOP_SCOPE_INIT_INFO que descrevem os escopos dos quais o usuário pode selecionar objetos. Esse membro não pode ser NULL e a matriz deve conter pelo menos um elemento porque o seletor de objetos não pode operar sem pelo menos um escopo.
flOptions
Sinalizadores que determinam as opções do seletor de objetos. Esse membro pode ser zero ou uma combinação de um ou mais dos sinalizadores a seguir.
DSOP_FLAG_MULTISELECT (0x00000001)
Se esse sinalizador estiver definido, o usuário poderá selecionar vários objetos. Se esse sinalizador não estiver definido, o usuário poderá selecionar apenas um objeto.
DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK (0x00000002)
Se esse sinalizador estiver definido e o sinalizador DSOP_SCOPE_TYPE_TARGET_COMPUTER estiver definido na matriz aDsScopeInfos , o computador de destino sempre será incluído na lista suspensa Pesquisar .
Se esse sinalizador não estiver definido e o computador de destino for um controlador de domínio de nível superior ou inferior, o sinalizador DSOP_SCOPE_TYPE_TARGET_COMPUTER será ignorado e o computador de destino não será incluído na lista suspensa Pesquisar .
Para economizar tempo durante a inicialização, esse sinalizador deverá ser definido se souber que o computador de destino não é um controlador de domínio. No entanto, se o computador de destino for um controlador de domínio, esse sinalizador não deverá ser definido porque é melhor para o usuário selecionar objetos de domínio no escopo do domínio em vez do próprio controlador de domínio.
cAttributesToFetch
Contém o número de elementos na matriz apwzAttributeNames . Esse membro pode ser zero.
apwzAttributeNames
Ponteiro para uma matriz de cadeias de caracteres Unicode terminadas em nulo que contêm os nomes dos atributos a serem recuperados para cada objeto selecionado. Se cAttributesToFetch for zero, esse membro será ignorado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Cabeçalho | objsel.h |