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 ());
Возвращаемое значение
Если hRes параметр имеет ненулевое значение, возвращает значение hRes. Если hRes равно нулю, то первые четыре версии AtlReportError возвращает DISP_E_EXCEPTION. Две последние версии возвращают результат макрос MAKE_HRESULT (1, FACILITY_ITF, nID ).
Параметры
clsid
[в] CLSID объекта, сообщает об ошибке.
lpszDesc
[в] Строка, описывающая ошибку. Версия Юникод определяет lpszDesc типа LPCOLESTR; версия ANSI указывает тип LPCSTR.
iid
[в] IID интерфейса, определяющего ошибку или — GUID_NULL если ошибка определяется операционной системой.
hRes
[в] HRESULT , вы хотите возвращается вызывающему объекту.
nID
[в] Идентификатор ресурса, где хранится строка описания ошибки. Это значение должно находиться между 0x0200 и 0xFFFF, включительно. В построениях отладки если nID не индексировать допустимая строка приведет ASSERT . В построениях выпуска строка описания ошибки будет присвоено значение «Неизвестная ошибка».
dwHelpID
[в] Идентификатор контекста справки для ошибки.
lpszHelpFile
[в] Путь и имя файла справки, описывающий ошибку.
hInst
[в] Дескриптор для ресурса. По умолчанию этот параметр является _Module::GetResourceInstance, где _Module — это глобальный экземпляр CComModule или класса, производного от него класса.
Примечания
Устанавливает интерфейс IErrorInfo для предоставления сведений об ошибках для клиентов объекта. Строка lpszDesc используется как текстовое описание ошибки. Клиент получает hRes возвращаемые из AtlReportError, клиент можно получить доступ к структуре IErrorInfo для сведения об ошибке.
Глобальные функции и макросы ATL
Родственные слова