support_error_info

Статья
08/04/2024

Реализует поддержку для возвращения подробных сведений об ошибках.

Синтаксис

[ support_error_info(error_interface=uuid) ]

Параметры

error_interface
Идентификатор реализуемого IErrorInfoинтерфейса.

Замечания

Атрибут support_error_info языка C++ реализует поддержку для возвращения на клиент подробных контекстных ошибок, обнаруженных для целевого объекта. Чтобы объект поддерживал ошибки, методы IErrorInfo интерфейса должны быть реализованы объектом. Дополнительные сведения см. в разделе Supporting IDispatch and IErrorInfo(Поддержка IDispatch и IErrorInfo).

Этот атрибут добавляет ISupportErrorInfoImpl в качестве базового класса для целевого объекта. Это приводит к реализации ISupportErrorInfo по умолчанию и может использоваться при возникновении ошибок в одном интерфейсе объекта.

Пример

Следующий код добавляет поддержку ISupportErrorInfo интерфейса в CMyClass объект по умолчанию.

// cpp_attr_ref_support_error_info.cpp
// compile with: /LD
#define _ATL_ATTRIBUTES
#include "atlbase.h"
#include "atlcom.h"

[module (name="mymod")];
[object, uuid("f0b17d66-dc6e-4662-baaf-76758e09c878")]
__interface IMyErrors
{
};

[ coclass, support_error_info("IMyErrors"),
  uuid("854dd392-bdc7-4781-8667-8757936f2a4f") ]
class CMyClass
{
};

Требования

Контекст атрибута	Значение
Относится к	`class`
Повторяемый	Да
Обязательные атрибуты	нет
Недопустимые атрибуты	нет

Дополнительные сведения о контекстах атрибутов см. в разделе Контексты атрибутов.

См. также

Атрибуты COM
Атрибуты классов

Поделиться через