Класс 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();}
Значение свойства
Описание исключения.