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 |
---|---|
|
O método foi bem-sucedido. |
|
Existe memória insuficiente para executar a operação. |
|
O parâmetro pIID não é um BSTR válido ou não se traduz em um GUID válido. |
|
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 |