Interface IDsObjectPicker (objsel.h)
A interface IDsObjectPicker é usada por um aplicativo para inicializar e exibir uma caixa de diálogo do seletor de objetos. Para criar uma instância dessa interface, chame CoCreateInstance com o identificador de classe CLSID_DsObjectPicker, conforme mostrado abaixo.
HRESULT hr = S_OK;
IDsObjectPicker *pDsObjectPicker = NULL;
hr = CoCreateInstance(CLSID_DsObjectPicker,
NULL,
CLSCTX_INPROC_SERVER,
IID_IDsObjectPicker,
(void **) &pDsObjectPicker);
O IDsObjectPicker implementado pelo sistema dá suporte a modelos apartment e free-threading e é thread-safe. Na prática, isso significa que uma chamada para os métodos dessa interface será bloqueada até que nenhum outro thread do aplicativo esteja chamando qualquer outro método nessa instância da interface.
Herança
A interface IDsObjectPicker herda da interface IUnknown . IDsObjectPicker também tem estes tipos de membros:
Métodos
A interface IDsObjectPicker tem esses métodos.
| IDsObjectPicker::Initialize O método IDsObjectPicker::Initialize inicializa a caixa de diálogo do seletor de objetos com dados sobre os escopos, filtros e opções usados pela caixa de diálogo seletor de objeto. |
| IDsObjectPicker::InvokeDialog Exibe uma caixa de diálogo seletor de objeto modal e retorna as seleções de usuário. |
Comentários
É aceitável criar e inicializar uma única instância da interface IDsObjectPicker e, em seguida, fazer várias chamadas para InvokeDialog sem precisar reinicializar a interface.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | objsel.h |