Compartilhar via


CWnd::InvokeHelper

Chamar essa função de membro para chamar o método ou propriedade do controle ActiveX especificado por dwDispID, no contexto especificado por wFlags.

void AFX_CDECL InvokeHelper( 
   DISPID dwDispID, 
   WORD wFlags, 
   VARTYPE vtRet, 
   void* pvRet, 
   const BYTE* pbParamInfo, 
   ...  
);

Parâmetros

  • dwDispID
    Identifica o método ou propriedade a ser chamados.

  • wFlags
    Sinalizadores que descrevem o contexto de chamada para IDispatch::Invoke.

  • vtRet
    Especifica o tipo do valor de retorno. Para valores possíveis, consulte a seção comentários para COleDispatchDriver::InvokeHelper.

  • pvRet
    O endereço de variável que receberá o valor da propriedade ou o valor de retorno. Deve corresponder ao tipo especificado por vtRet.

  • pbParamInfo
    Ponteiro para uma cadeia de caracteres NULL- finalizada de bytes que especifica os tipos de parâmetro depois de pbParamInfo. Para valores possíveis, consulte a seção comentários para COleDispatchDriver::InvokeHelper.

  • ...
    Variável lista de parâmetros de tipos, especificados em pbParamInfo.

Comentários

O parâmetro de pbParamInfo especifica os tipos dos parâmetros passados para o método ou propriedade. A lista de argumentos variável é representada por na declaração de sintaxe.

Essa função converte os parâmetros para valores de VARIANTARG , então chama o método de IDispatch::Invoke no controle ActiveX. Se a chamada a IDispatch::Invoke falhar, essa função irá acionar uma exceção. Se SCODE (código de status) retornado por IDispatch::Invoke é DISP_E_EXCEPTION, gera de essa função um objeto de COleException , se não lança COleDispatchException.

Dica

Essa função deve ser chamado somente em um objeto de CWnd que representa um controle ActiveX.

Para obter mais informações sobre como usar essa função de membro com recipiente de controles ActiveX, consulte o artigo Recipiente de controles ActiveX: Controles ActiveX de programação em um recipiente de controles ActiveX.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

CWnd::GetProperty

CWnd::SetProperty

Classe COleDispatchDriver

CWnd::CreateControl