Класс 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