estrutura DSOP_SCOPE_INIT_INFO (objsel.h)
A estrutura DSOP_SCOPE_INIT_INFO descreve um ou mais tipos de escopo que têm os mesmos atributos. Um tipo de escopo é um tipo de local, por exemplo, um domínio, computador ou Catálogo Global, do qual o usuário pode selecionar objetos. Essa estrutura é usada com DSOP_INIT_INFO ao chamar IDsObjectPicker::Initialize.
Sintaxe
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;
Membros
cbSize
Contém o tamanho, em bytes, da estrutura .
flType
Sinalizadores que indicam os tipos de escopo descritos por essa estrutura. Você poderá combinar vários tipos de escopo se todos os escopos especificados usarem as mesmas configurações. Esse membro pode ser uma combinação dos sinalizadores a seguir.
DSOP_SCOPE_TYPE_TARGET_COMPUTER (0x00000001)
Computador especificado pelo membro pwzTargetComputer da estrutura DSOP_INIT_INFO .
Se o computador de destino for um controlador de domínio de nível superior ou inferior, esse sinalizador será ignorado, a menos que o sinalizador DSOP_FLAG_SKIP_TARGET_COMPUTER_DC_CHECK seja definido no membro flOptions da estrutura DSOP_INIT_INFO .
DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN (0x00000002)
Um domínio de nível superior ao qual o computador de destino está ingressado. Se esse sinalizador estiver definido, use o membro pwzDcName para especificar o nome de um controlador de domínio no domínio ingressado.
DSOP_SCOPE_TYPE_DOWNLEVEL_JOINED_DOMAIN (0x00000004)
Um domínio de nível inferior ao qual o computador de destino está ingressado.
DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN (0x00000008)
Todos os domínios na empresa à qual o computador de destino pertence. Se o escopo DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN for especificado, o escopo DSOP_SCOPE_TYPE_ENTERPRISE_DOMAIN representará todos os domínios na empresa, exceto o domínio ingressado.
DSOP_SCOPE_TYPE_GLOBAL_CATALOG (0x00000010)
Um escopo que contém objetos de todos os domínios na empresa. Uma empresa pode conter apenas domínios de nível superior.
DSOP_SCOPE_TYPE_EXTERNAL_UPLEVEL_DOMAIN (0x00000020)
Todos os domínios de nível superior externos à empresa, mas confiáveis pelo domínio ao qual o computador de destino está ingressado.
DSOP_SCOPE_TYPE_EXTERNAL_DOWNLEVEL_DOMAIN (0x00000040)
Todos os domínios de nível inferior externos à empresa, mas confiáveis pelo domínio ao qual o computador de destino está ingressado.
DSOP_SCOPE_TYPE_WORKGROUP (0x00000080)
O grupo de trabalho ao qual o computador de destino está ingressado. Aplica-se somente se o computador de destino não estiver ingressado em um domínio.
O único tipo de objeto que pode ser selecionado em um grupo de trabalho é um computador.
DSOP_SCOPE_TYPE_USER_ENTERED_UPLEVEL_SCOPE (0x00000100)
Permite que o usuário insira um escopo de nível superior. Se nenhum dos tipos DSOP_SCOPE_TYPE_USER_ENTERED_* for especificado, a caixa de diálogo restringirá o usuário aos escopos na lista suspensa Pesquisar .
DSOP_SCOPE_TYPE_USER_ENTERED_DOWNLEVEL_SCOPE (0x00000200)
Permite que o usuário insira um escopo de nível inferior.
flScope
Sinalizadores que indicam o formato usado para retornar ADsPath para objetos selecionados nesse escopo. O membro flScope também pode indicar o escopo inicial exibido na lista suspensa Examinar . Esse membro pode ser uma combinação dos sinalizadores a seguir.
Os caminhos LDAP e GC (Catálogo Global) podem ser convertidos na sintaxe do WinNT ADsPath. Os caminhos do GC podem ser convertidos no formato LDAP. Objetos WinNT com um atributo objectSid poderão ser convertidos no formato LDAP se você especificar os sinalizadores DSOP_SCOPE_FLAG_WANT_SID_PATH ou DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP . Nenhuma outra conversão é legal.
DSOP_SCOPE_FLAG_STARTING_SCOPE (0x00000001)
O escopo descrito por essa estrutura é inicialmente selecionado na lista suspensa Pesquisar . Somente um escopo pode especificar esse sinalizador. Se nenhum escopo especificar esse sinalizador, o escopo inicial será o primeiro escopo criado com êxito na matriz de escopos passados para o método IDsObjectPicker::Initialize .
DSOP_SCOPE_FLAG_WANT_PROVIDER_WINNT (0x00000002)
Os ADsPaths são convertidos para usar o provedor WinNT. Para obter mais informações, consulte WinNT ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_LDAP (0x00000004)
Os ADsPaths são convertidos para usar o provedor LDAP. Para obter mais informações, consulte LDAP ADsPath.
DSOP_SCOPE_FLAG_WANT_PROVIDER_GC (0x00000008)
Os ADsPaths para objetos selecionados nesse escopo são convertidos para usar o provedor de GC.
DSOP_SCOPE_FLAG_WANT_SID_PATH (0x00000010)
Os ADsPaths com um atributo objectSid são convertidos no formulário LDAP://< SID=x> , em que x representa os dígitos hexadecimal do valor do atributo objectSid.
DSOP_SCOPE_FLAG_WANT_DOWNLEVEL_BUILTIN_PATH (0x00000020)
Os ADsPaths para objetos SID conhecidos e de nível inferior são uma cadeia de caracteres vazia, a menos que esse sinalizador seja especificado (por exemplo; DSOP_DOWNLEVEL_FILTER_INTERACTIVE). Se esse sinalizador for especificado, os caminhos terão o formulário
WinNT://NT AUTHORITY/Interactive ou WinNT://Creator proprietário.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_USERS (0x00000040)
Se o filtro de escopo contiver usuários, selecione a caixa Usuários marcar na caixa de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_GROUPS (0x00000080)
Se o filtro de escopo contiver grupos, selecione a caixa grupos marcar na caixa de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_COMPUTERS (0x00000100)
Se o filtro de escopo contiver computadores, selecione a caixa computadores marcar na caixa de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_CONTACTS (0x00000200)
Se o filtro de escopo contiver contatos, selecione a caixa contatos marcar na caixa de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_SERVICE_ACCOUNTS (0x00000400)
Se o filtro de escopo contiver contas de serviço, selecione as caixas Contas de Serviço e Contas de Serviço Gerenciado de Grupo marcar na caixa de diálogo.
DSOP_SCOPE_FLAG_DEFAULT_FILTER_PASSWORDSETTINGS_OBJECTS (0x00000800)
Se o filtro de escopo contiver objetos de configuração de senha, selecione a caixa objetos de configuração de senha marcar na caixa de diálogo.
FilterFlags
Contém uma estrutura DSOP_FILTER_FLAGS que indica os tipos de objetos apresentados ao usuário para esse escopo ou escopos.
pwzDcName
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome de um controlador de domínio do domínio ao qual o computador de destino está ingressado. Esse membro será usado somente se o membro flType contiver o sinalizador DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN . Se esse sinalizador não estiver definido, pwzDcName deverá ser NULL.
Esse membro pode ser NULL mesmo se o sinalizador DSOP_SCOPE_TYPE_UPLEVEL_JOINED_DOMAIN for especificado; nesse caso, a caixa de diálogo pesquisa o controlador de domínio. Esse membro permite que você nomeie um controlador de domínio específico em um domínio multimaster. Por exemplo, um aplicativo administrativo pode fazer alterações em um controlador de domínio em um domínio multimaster e abrir a caixa de diálogo do seletor de objetos antes que as alterações sejam replicadas nos outros controladores de domínio.
pwzADsPath
Reservados; deve ser NULL.
hr
Contém um valor HRESULT que indica o status do escopo específico. Se o método IDsObjectPicker::Initialize criar com êxito o escopo ou os escopos especificados por essa estrutura, hr conterá S_OK. Caso contrário, hr contém um código de erro.
Se IDsObjectPicker::Initialize retornar S_OK, os membros de rh de todas as estruturas de DSOP_SCOPE_INIT_INFO especificadas também conterão S_OK.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Cabeçalho | objsel.h |