Método IQuickActivate::QuickActivate (ocidl.h)
O Quick ativa um controle .
Sintaxe
HRESULT QuickActivate(
[in] QACONTAINER *pQaContainer,
[in, out] QACONTROL *pQaControl
);
Parâmetros
[in] pQaContainer
Um ponteiro para a estrutura QACONTAINER que contém informações sobre o contêiner.
[in, out] pQaControl
Um ponteiro para a estrutura QACONTROL preenchida pelo controle para retornar informações sobre o controle para o contêiner. O contêiner que chama esse método deve reservar memória para essa estrutura.
Valor retornado
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, será E_FAIL.
Comentários
Se o controle não der suporte a IQuickActivate, o contêiner executará determinadas operações de handshaking quando carregar o controle. O contêiner chama determinadas interfaces no controle e o controle, por sua vez, chama de volta para determinadas interfaces no site cliente do contêiner. Primeiro, o contêiner cria o objeto de controle e chama QueryInterface para consultar as interfaces necessárias. Em seguida, o contêiner chama IOleObject::SetClientSite no controle, passando um ponteiro para seu site cliente. Em seguida, o controle chama QueryInterface neste site, recuperando um ponteiro para interfaces adicionais necessárias.
Usando o método QuickActivate , o contêiner passa um ponteiro para uma estrutura QACONTAINER . A estrutura contém ponteiros para interfaces que são necessárias para o controle e os valores de algumas propriedades de ambiente que o controle pode precisar. Após o retorno, o controle passa um ponteiro para uma estrutura QACONTROL que contém ponteiros para as próprias interfaces que o contêiner requer, bem como informações de status adicionais.
Os métodos IPersist*::Load e IPersist*::InitNew devem ser chamados após a ativação rápida. O controle deve estabelecer suas conexões com os coletores do contêiner durante a ativação rápida. No entanto, essas conexões não estão ativas até que IPersist*::Load ou IPersist*::InitNew tenha sido chamado.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | ocidl.h |