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

Confira também

IPersistFile

Ipersiststorage

Ipersiststream

Ipersiststreaminit

IQuickActivate