Método ITDispatchMapper::QueryDispatchInterface (tapi3if.h)

O método QueryDispatchInterface retorna um ponteiro de expedição para uma interface diferente em um objeto, considerando seu GUID e o ponteiro de expedição de outra interface no objeto .

Sintaxe

HRESULT QueryDispatchInterface(
  [in]  BSTR      pIID,
  [in]  IDispatch *pInterfaceToMap,
  [out] IDispatch **ppReturnedInterface
);

Parâmetros

[in] pIID

Ponteiro para a representação BSTR do GUID para a interface necessária.

[in] pInterfaceToMap

Ponteiro IDispatch da interface inicial.

[out] ppReturnedInterface

Ponteiro IDispatch da interface correspondente ao GUID contido em pIID.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_OUTOFMEMORY
Existe memória insuficiente para executar a operação.
E_INVALIDARG
O parâmetro pIID não é um BSTR válido ou não se traduz em um GUID válido.
E_NOINTERFACE
A interface solicitada não é exposta ou o objeto não implementa a interface IObjectSafety .

Comentários

O aplicativo deve usar SysAllocString para alocar memória para o parâmetro pIID e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

O Mapeador de Expedição usará a interface IObjectSafety do objeto para garantir que o objeto seja seguro para scripts na interface solicitada. Se o objeto não implementar IObjectSafety ou se o objeto não estiver seguro nessa interface específica, a chamada falhará.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

ITDispatchMapper