Metodo ITDispatchMapper::QueryDispatchInterface (tapi3if.h)

Il metodo QueryDispatchInterface restituisce un puntatore dispatch a un'interfaccia diversa in un oggetto in base al GUID e al puntatore dispatch di un'altra interfaccia nell'oggetto .

Sintassi

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

Parametri

[in] pIID

Puntatore alla rappresentazione BSTR del GUID per l'interfaccia necessaria.

[in] pInterfaceToMap

Puntatore IDispatch dell'interfaccia iniziale.

[out] ppReturnedInterface

Puntatore IDispatch dell'interfaccia corrispondente al GUID contenuto in pIID.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_INVALIDARG	Il parametro pIID non è un BSTR valido o non si traduce in un GUID valido.
E_NOINTERFACE	L'interfaccia richiesta non è esposta o l'oggetto non implementa l'interfaccia IObjectSafety .

Commenti

L'applicazione deve usare SysAllocString per allocare memoria per il parametro pIID e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.

Dispatch Mapper userà l'interfaccia IObjectSafety dell'oggetto per assicurarsi che l'oggetto sia sicuro per lo scripting nell'interfaccia richiesta. Se l'oggetto non implementa IObjectSafety o se l'oggetto non è sicuro in questa particolare interfaccia, la chiamata avrà esito negativo.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	tapi3if.h (include Tapi3.h)
Libreria	Uuid.lib
DLL	Tapi3.dll

Vedi anche

ITDispatchMapper