Partager via


COM_INTERFACE_ENTRY_FUNC

Un mécanisme général pour raccorder dans QueryInterface ATL la logique.

COM_INTERFACE_ENTRY_FUNC( iid, dw, func )

Paramètres

  • iid
    [in] GUID de l'interface exposée.

  • dw
    [in] un paramètre passé à func.

  • func
    [in] Le pointeur fonction qui retourne iid.

Notes

Si l'IID correspond à l'IID de l'interface interrogé pour, la fonction définie par func est appelée. La déclaration de la fonction doit être :

HRESULT WINAPI func(void* pv, REFIID riid, LPVOID* ppv, DWORD_PTR dw);

Lorsque la fonction est appelée, les points d' pv à votre objet de classe. Le paramètre d' riid fait référence à l'interface interrogée pour, ppv est le pointeur à l'emplacement où la fonction doit stocker le pointeur vers l'interface, et dw est le paramètre que vous avez spécifié dans l'entrée. La fonction doit définir *ppv à NULL et E_NOINTERFACE de retour ou S_FALSE si elle choisit de ne pas retourner une interface. Avec E_NOINTERFACE, le traitement de mappage COM se termine. Avec S_FALSE, le traitement de mappage COM continue, bien qu'aucun pointeur d'interface n'a été retourné. Si la fonction retourne un pointeur d'interface, elle doit retourner S_OK.

Consultez De macros COM_INTERFACE_ENTRY pour les notes sur les entrées de mappage COM.

Configuration requise

Header: atlcom.h

Voir aussi

Autres ressources

Macros de mappage COM

Macros ATL