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 |
---|---|
|
El método se realizó correctamente. |
|
Existe memoria insuficiente para realizar la operación. |
|
El parámetro pIID no es un BSTR válido o no se traduce en un GUID válido. |
|
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 |