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 ());
Valor devuelto
Si el parámetro hRes es distinto de cero, devuelve el valor de hRes. Si hRes es cero, las cuatro primeras versiones de AtlReportError volver DISP_E_EXCEPTION. Las dos últimas versiones devolución el resultado de la macro MAKE_HRESULT (1, FACILITY_ITF, nID ).
Parámetros
clsid
[en] El CLSID del objeto informar el error.
lpszDesc
[en] La cadena que describe el error. La versión Unicode especifica lpszDesc es de tipo LPCOLESTR; la versión ANSI especifica un tipo de LPCSTR.
iid
[en] El IID de la interfaz que define el error o GUID_NULL si el error es definido por el sistema operativo.
hRes
[en] HRESULT desea devuelve al llamador.
nID
[en] El identificador de recursos donde se almacena la cadena de descripción del error. Este valor debe estar entre 0x0200 y 0xFFFF, inclusive. En versiones de depuración, dará como resultado una ASERCIÓN si nID no indizar una cadena válida. En versiones de lanzamiento, se establecerá la cadena de descripción del error en "Error desconocido".
dwHelpID
[en] El identificador de contexto de ayuda del error.
lpszHelpFile
[en] La ruta y el nombre del archivo de ayuda que describe el error.
hInst
[en] El identificador del recurso. De forma predeterminada, este parámetro es _Module::GetResourceInstance, donde _Module es la instancia Mundial de CComModule o una clase derivada de ella.
Observaciones
Configura el IErrorInfo interfaz para proporcionar información de error a los clientes del objeto. La cadena lpszDesc se utiliza como la descripción del error. Cuando el cliente recibe hRes que volver desde AtlReportError, el cliente puede acceder a la estructura de IErrorInfo para obtener información detallada sobre el error.
ATL Macros y funciones globales
Véase también