| UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:tapi3if.ITDispatchMapper.QueryDispatchInterface |
ITDispatchMapper::QueryDispatchInterface (tapi3if.h) |
The QueryDispatchInterface method returns a dispatch pointer to a different interface on an object given its GUID and the dispatch pointer of another interface on the object. |
|
tapi3\itdispatchmapper_querydispatchinterface.htm |
tapi3 |
7ee7c6f4-5710-4300-a2b8-de9aecf0528b |
12/05/2018 |
ITDispatchMapper interface [TAPI 2.2],QueryDispatchInterface method, ITDispatchMapper.QueryDispatchInterface, ITDispatchMapper::QueryDispatchInterface, QueryDispatchInterface, QueryDispatchInterface method [TAPI 2.2], QueryDispatchInterface method [TAPI 2.2],ITDispatchMapper interface, _tapi3_itdispatchmapper_querydispatchinterface, tapi3.itdispatchmapper_querydispatchinterface, tapi3if/ITDispatchMapper::QueryDispatchInterface |
tapi3if.h |
Tapi3.h |
Windows |
Uuid.lib |
Tapi3.dll |
Windows |
19H1 |
|
|
|
|
|
|
The QueryDispatchInterface method returns a dispatch pointer to a different interface on an object given its GUID and the dispatch pointer of another interface on the object.
Pointer to BSTR representation of GUID for needed interface.
IDispatch pointer of starting interface.
IDispatch pointer of interface corresponding the GUID contained in pIID.
This method can return one of these values.
| Return code | Description |
|---|---|
|
Method succeeded. |
|
Insufficient memory exists to perform the operation. |
|
The pIID parameter either is not a valid BSTR or does not translate into a valid GUID. |
|
The interface requested is not exposed or the object does not implement the IObjectSafety interface. |
The application must use SysAllocString to allocate memory for the pIID parameter and use SysFreeString to free the memory when the variable is no longer needed.
The Dispatch Mapper will use the object's IObjectSafety interface to make sure the object is safe for scripting on the requested interface. If the object does not implement IObjectSafety, or if the object is not safe on this particular interface, the call will fail.