Marshal.GetExceptionForHR Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Преобразует код ошибки HRESULT в соответствующий Exception объект.
Перегрузки
| Имя | Описание |
|---|---|
| GetExceptionForHR(Int32) |
Преобразует указанный код ошибки HRESULT в соответствующий Exception объект. |
| GetExceptionForHR(Int32, IntPtr) |
Преобразует указанный код ошибки HRESULT в соответствующий Exception объект с дополнительными сведениями об ошибках, передаваемыми в интерфейсе IErrorInfo для объекта исключения. |
| GetExceptionForHR(Int32, Guid, IntPtr) |
GetExceptionForHR(Int32)
- Исходный код:
- Marshal.cs
- Исходный код:
- Marshal.cs
- Исходный код:
- Marshal.cs
- Исходный код:
- Marshal.cs
- Исходный код:
- Marshal.cs
Преобразует указанный код ошибки HRESULT в соответствующий Exception объект.
public:
static Exception ^ GetExceptionForHR(int errorCode);[System.Security.SecurityCritical]
public static Exception GetExceptionForHR(int errorCode);public static Exception? GetExceptionForHR(int errorCode);public static Exception GetExceptionForHR(int errorCode);[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int -> Exceptionstatic member GetExceptionForHR : int -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer) As ExceptionПараметры
- errorCode
- Int32
Преобразование HRESULT.
Возвращаемое значение
Объект, представляющий преобразованный HRESULT, или null если значение HRESULT не представляет код ошибки (например, S_OK или S_FALSE).
- Атрибуты
Комментарии
GetExceptionForHR Используйте метод для получения Exception на основе HRESULT без вызова ThrowExceptionForHR метода и перехвата исключения.
Текущий интерфейс IErrorInfo используется для создания исключения.
Сопоставление каждого HRESULT с сопоставимым классом исключений в .NET Framework см. в разделе How to: Map HRESULTs and Exceptions.
См. также раздел
Применяется к
GetExceptionForHR(Int32, IntPtr)
- Исходный код:
- Marshal.cs
- Исходный код:
- Marshal.cs
- Исходный код:
- Marshal.cs
- Исходный код:
- Marshal.cs
- Исходный код:
- Marshal.cs
Преобразует указанный код ошибки HRESULT в соответствующий Exception объект с дополнительными сведениями об ошибках, передаваемыми в интерфейсе IErrorInfo для объекта исключения.
public:
static Exception ^ GetExceptionForHR(int errorCode, IntPtr errorInfo);[System.Security.SecurityCritical]
public static Exception GetExceptionForHR(int errorCode, IntPtr errorInfo);public static Exception? GetExceptionForHR(int errorCode, IntPtr errorInfo);public static Exception GetExceptionForHR(int errorCode, IntPtr errorInfo);[<System.Security.SecurityCritical>]
static member GetExceptionForHR : int * nativeint -> Exceptionstatic member GetExceptionForHR : int * nativeint -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer, errorInfo As IntPtr) As ExceptionПараметры
- errorCode
- Int32
Преобразование HRESULT.
- errorInfo
-
IntPtr
nativeint
Указатель на IErrorInfo интерфейс, предоставляющий дополнительные сведения об ошибке. Можно указать IntPtr(0) , чтобы использовать текущий IErrorInfo интерфейс или IntPtr(-1) игнорировать текущий IErrorInfo интерфейс и создавать исключение только из кода ошибки.
Возвращаемое значение
Объект, представляющий преобразованные данные HRESULT и полученные от errorInfoнее данные, или null если значение HRESULT не представляет код ошибки (например, S_OK или S_FALSE).
- Атрибуты
Комментарии
GetExceptionForHR Используйте метод для получения Exception на основе HRESULT без вызова ThrowExceptionForHR метода и перехвата исключения (таким образом, избегая соответствующих затрат на производительность). Параметр errorInfo предоставляет дополнительные сведения об ошибке, например его текстовое описание и глобальный уникальный идентификатор (GUID) для интерфейса, определяющего ошибку.
Используйте эту перегрузку метода, если у вас есть пользовательские сведения об ошибках, которые необходимо указать в преобразовании.
Сопоставление каждого HRESULT с сопоставимым классом исключений в .NET Framework см. в разделе How to: Map HRESULTs and Exceptions.
См. также раздел
Применяется к
GetExceptionForHR(Int32, Guid, IntPtr)
- Исходный код:
- Marshal.cs
- Исходный код:
- Marshal.cs
public:
static Exception ^ GetExceptionForHR(int errorCode, Guid % iid, IntPtr pUnk);public static Exception? GetExceptionForHR(int errorCode, in Guid iid, IntPtr pUnk);static member GetExceptionForHR : int * Guid * nativeint -> ExceptionPublic Shared Function GetExceptionForHR (errorCode As Integer, ByRef iid As Guid, pUnk As IntPtr) As ExceptionПараметры
- errorCode
- Int32
- iid
- Guid
- pUnk
-
IntPtr
nativeint
