Método IDsAdminCreateObj::CreateModal (dsadmin.h)
O método IDsAdminCreateObj::CreateModal exibe o assistente de criação de objeto e retorna o objeto recém-criado. O método IDsAdminCreateObj::Initialize deve ser chamado antes que IDsAdminCreateObj::CreateModal possa ser chamado.
Sintaxe
HRESULT CreateModal(
[in] HWND hwndParent,
[out] IADs **ppADsObj
);
Parâmetros
[in] hwndParent
Contém o identificador de janela do proprietário do assistente. Esse valor não pode ser NULL. Use o resultado da função GetDesktopWindow se nenhuma janela pai estiver disponível.
[out] ppADsObj
Ponteiro para um ponteiro de interface IADs que recebe o objeto recém-criado. Esse parâmetro receberá NULL se o assistente de criação de objeto falhar ou for cancelado. O chamador deve liberar essa interface quando ela não for mais necessária. Esse parâmetro poderá ser NULL se esse objeto não for necessário.
Retornar valor
Esse método pode retornar um desses valores.
Retorna um código de erro definido por OLE ou um dos valores a seguir.
Comentários
Se o usuário cancelar o assistente de criação de objeto, esse método retornará S_FALSE. Se ppADsObj não for NULL, ppADsObj receberá um valor NULL . Por isso, o uso da macro SUCCEEDED para determinar se ppADsObj é válido deve ser evitado. Sempre teste o conteúdo de ppADsObj para obter um valor não NULL antes de usar o ponteiro de 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 | dsadmin.h |
| DLL | DSAdmin.dll |