Класс Platform::COMException

  • Статья

Представляет ошибки COM, возникающие при выполнении приложения. COMException — базовый класс для набора предопределенных стандартных исключений.

Синтаксис

public ref class COMException : Exception,    IException,    IPrintable,    IEquatable

Участники

Класс COMException наследует от класса Object и интерфейсов IException, IPrintable и IEquatable.

Класс COMException также имеет следующие типы членов.

Конструкторы

Элемент Description
COMException Инициализирует новый экземпляр класса COMException.

Методы

Класс COMException наследует методы Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() и ToString() от класса Platform::Object Class.

Свойства

Класс COMException имеет следующие свойства.

Элемент Description
Исключение::HResult Значение HRESULT, соответствующее исключению.
Exception::Message Сообщение с описанием исключения.

Производные исключения

Следующие предопределенные исключения наследуются от класса COMException. Они отличаются от класса COMException только своими именами, именами своих конструкторов и значениями HRESULT.

Имя Значение HRESULT Description
COMException Определяемое пользователем значение hresult Возникает при возвращении неизвестного значения HRESULT после вызова метода COM.
AccessDeniedException E_ACCESSDENIED Возникает при запрете доступа к ресурсу или функции.
ChangedStateException E_CHANGED_STATE Возникает, если метод итератора коллекции или представления коллекции вызван после изменения родительской коллекции, что делает результаты метода недействительными.
ClassNotRegisteredException REGDB_E_CLASSNOTREG Возникает, если COM-класс не зарегистрирован.
DisconnectedException RPC_E_DISCONNECTED Возникает, если объект отключен от своих клиентов.
FailureException E_FAIL Возникает, если операция завершается неудачно.
InvalidArgumentException E_INVALIDARG Вызывается, если один из передаваемых методу аргументов является недопустимым.
InvalidCastException E_NOINTERFACE Возникает, если тип не удается привести к другому типу.
NotImplementedException E_NOTIMPL Возникает, если метод интерфейса не реализован в классе.
NullReferenceException E_POINTER Возникает при попытке разыменовать ссылку на объект NULL.
OperationCanceledException E_ABORT Возникает при отмене операции.
OutOfBoundsException E_BOUNDS Возникает, когда операция пытается получить доступ к данным за пределами допустимого диапазона.
OutOfMemoryException E_OUTOFMEMORY Возникает, если недостаточно памяти для выполнения операции.

Требования

Минимальный поддерживаемый клиент: Windows 8

Минимальный поддерживаемый сервер: Windows Server 2012

Пространство имен: Platform

Метаданные: platform.winmd

Конструктор COMException::COMException

Инициализирует новый экземпляр класса COMException.

Синтаксис

COMException( int hresult )

Параметры

hresult
HRESULT ошибки, представляемый этим исключением.

Свойство COMException::HResult

Значение HRESULT, соответствующее исключению.

Синтаксис

public:
    property int HResult { int get();}

Значение свойства

Значение HRESULT, задающее ошибку.

Замечания

Дополнительные сведения о интерпретации значения HRESULT см. в разделе "Структура кодов ошибок COM".

Свойство COMException::Message

Сообщение с описанием исключения.

Синтаксис

public:property String^ Message {    String^ get();}

Значение свойства

Описание исключения.

См. также

Пространство имен Platform