HRESULT WINAPI AtlReportError (const CLSIDamp ; CLSID, LPCOLESTR lpszDescconst IID & IID = GUID_NULL, HRESULT hRes = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp ; CLSID, LPCOLESTR lpszDescDWORDdwHelpIDLPCOLESTRlpszHelpFileconst IID & IID = GUID_NULL, HRESULT hRes = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp ; CLSID, LPCSTR lpszDesc, const IID & IID = GUID_NULL, HRESULT hRes = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp ; CLSID, LPCSTR lpszDescDWORDdwHelpIDLPCSTRlpszHelpFileconst IID & IID = GUID_NULL, HRESULT hRes = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp ; CLSID, UINT nID, const IID & IID = GUID_NULL, HRESULT hRes = 0, HINSTANCEhInst= _Module.GetResourceInstance ()) ;
HRESULT WINAPI AtlReportError (const CLSIDamp ; CLSID, UINT nIDDWORDdwHelpIDLPCOLESTRlpszHelpFileconst IID & IID = GUID_NULL, HRESULT hRes = 0, HINSTANCEhInst= _Module.GetResourceInstance ()) ;
Valeur de retour
Si le paramètre hRes est différente de zéro, renvoie la valeur de hRes. Si hRes est égale à zéro, les quatre premières versions de AtlReportError retournent DISP_E_EXCEPTION. Les deux dernières versions retournent le résultat de la macro MAKE_HRESULT (1, FACILITY_ITF, nID ).
Paramètres
clsid
[en] Le CLSID de l'objet de l'erreur.
lpszDesc
[en] Chaîne décrivant l'erreur. La version Unicode spécifie que lpszDesc est de type LPCOLESTR; la version ANSI spécifie un type de LPCSTR.
iid
[en] L'IID de l'interface de définition de l'erreur ou le GUID_NULL si l'erreur est définie par le système d'exploitation.
hRes
[en] HRESULT vous souhaitez retourné à l'appelant.
nID
[en] L'identificateur de ressource où la chaîne de description de l'erreur est stockée. Cette valeur devrait être entre 0 et 0xFFFF, inclusivement. Dans les versions de débogage, un ASSERT se traduira si le nID n'indexe pas une chaîne valide. Dans les versions release, la chaîne de description de l'erreur sera définie à « Erreur inconnue ».
dwHelpID
[en] L'identificateur de contexte d'aide de l'erreur.
lpszHelpFile
[en] Le chemin d'accès et le nom du fichier d'aide décrivant l'erreur.
hInst
[en] La poignée à la ressource. Par défaut, ce paramètre est _Module::GetResourceInstance, où _Module est l'instance mondiale de CComModule ou une classe dérivée de celui-ci.
Remarques
Met en place le interface IErrorInfo pour fournir des informations d'erreur pour les clients de l'objet. La chaîne lpszDesc est utilisé comme la description textuelle de l'erreur. Lorsque le client reçoit les hRes que vous renvoyer à partir de AtlReportError, le client peut accéder à la structure de IErrorInfo pour plus de détails sur l'erreur.
Les Macros ATL et fonctions globales
Voir aussi