IHTMLVIEWMODEL_QUERYINTERFACE()
Brew Release
Brew MP 1.0.2
See Also
- IQI_QueryInterface()
Description
This function queries an interface for an alternate interface that may
provide extended functionality or a proprietary extension. If successful,
the function will return a pointer to the requested interface in the memory
location pointed to by the 'd' parameter. The requested interface is
identified by a globally unique ID passed to the function in the 'c'
parameter.
Params
pif
[]:
[in] Pointer to the IHTMLViewModel interface object.
c
[]:
[in] A globally unique id that identifies the interface to be queried.
d
[]:
[out] Address of a memory location that will receive the requrested
interface pointer. If the queried item is not available, this
pointer is returned as NULL.
Interface
Prototype
int IHTMLViewModel_QueryInterface(IHTMLViewModel *pif, AEECLSID c, void **d);
Return
AEE_SUCCESS - The requested interface was found and has been returned in the 'd' parameter. ECLASSNOTSUPPORT - The requested interface is not supported.
Side Effect
- Upon successful retrieval of an interface pointer, that interface is returned with its reference count incremented. The caller is responsible for releasing this object at some point in the future.
Comments
The pointer passed in the 'd' parameter is a double-indirection -- i.e., it
is a pointer to a pointer. Applications should use care in ensuring that the
proper level of indirection is used in calling the function.
COMMENTS (0)
See Below