Compartir a través de


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

El método QueryDispatchInterface devuelve un puntero de distribución a una interfaz diferente en un objeto dado su GUID y el puntero de distribución de otra interfaz en el objeto.

Sintaxis

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

Parámetros

[in] pIID

Puntero a la representación BSTR del GUID para la interfaz necesaria.

[in] pInterfaceToMap

Puntero IDispatch de la interfaz de inicio.

[out] ppReturnedInterface

Puntero IDispatch de la interfaz correspondiente al GUID contenido en pIID.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
El método se realizó correctamente.
E_OUTOFMEMORY
Existe memoria insuficiente para realizar la operación.
E_INVALIDARG
El parámetro pIID no es un BSTR válido o no se traduce en un GUID válido.
E_NOINTERFACE
La interfaz solicitada no se expone o el objeto no implementa la interfaz IObjectSafety .

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pIID y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

El asignador de distribución usará la interfaz IObjectSafety del objeto para asegurarse de que el objeto es seguro para el scripting en la interfaz solicitada. Si el objeto no implementa IObjectSafety o si el objeto no es seguro en esta interfaz en particular, se producirá un error en la llamada.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado tapi3if.h (include Tapi3.h)
Library Uuid.lib
Archivo DLL Tapi3.dll

Consulte también

ITDispatchMapper