Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La méthode QueryDispatchInterface retourne un pointeur de répartition vers une autre interface sur un objet en fonction de son GUID et du pointeur de répartition d’une autre interface sur l’objet.
Syntaxe
HRESULT QueryDispatchInterface(
[in] BSTR pIID,
[in] IDispatch *pInterfaceToMap,
[out] IDispatch **ppReturnedInterface
);
Paramètres
[in] pIID
Pointeur vers la représentation BSTR du GUID pour l’interface nécessaire.
[in] pInterfaceToMap
Pointeur IDispatch de l’interface de démarrage.
[out] ppReturnedInterface
Pointeur IDispatch de l’interface correspondant au GUID contenu dans pIID.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La méthode a réussi. |
|
La mémoire est insuffisante pour effectuer l’opération. |
|
Le paramètre pIID n’est pas un BSTR valide ou ne se traduit pas en GUID valide. |
|
L’interface demandée n’est pas exposée ou l’objet n’implémente pas l’interface IObjectSafety . |
Remarques
L’application doit utiliser SysAllocString pour allouer de la mémoire pour le paramètre pIID et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.
Le mappeur dispatch utilise l’interface IObjectSafety de l’objet pour s’assurer que l’objet est sécurisé pour le script sur l’interface demandée. Si l’objet n’implémente pas IObjectSafety ou si l’objet n’est pas sécurisé sur cette interface particulière, l’appel échoue.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |