COleDispatchDriver::InvokeHelper

Artigo
02/25/2013

Chama o método ou propriedade do objeto 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..Para obter uma lista de valores possíveis, consulte o parâmetro de wFlags em IDispatch::Invoke em Windows SDK.
vtRet
Especifica o tipo do valor de retorno.Para valores possíveis, consulte a seção comentários.
pvRet
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.
...
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.

Os valores possíveis para o argumento de vtRet são tirados de enumeração de VARENUM .Os valores possíveis são:

Símbolo	Tipo de retorno
VT_EMPTY	void
VT_I2	short
VT_I4	long
VT_R4	float
VT_R8	double
VT_CY	CY
VT_DATE	DATA
VT_BSTR	BSTR
VT_DISPATCH	LPDISPATCH
VT_ERROR	SCODE
VT_BOOL	BOOL
VT_VARIANT	VARIANTE
VT_UNKNOWN	LPUNKNOWN

O argumento de pbParamInfo é uma lista separada espaço- de constantes VTS_ .Um ou mais de esses valores, separados por espaços (não vírgulas), especifique a lista de parâmetros da função.Os valores possíveis são listados com a macro de EVENT_CUSTOM .

Essa função converte os parâmetros para valores de VARIANTARG , então chama o método de IDispatch::Invoke .Se a chamada a 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.

Para obter mais informações, consulte VARIANTARG, Implementing the IDispatch Interface, IDispatch::Invoke, e Estrutura de códigos de erro COM em Windows SDK.