Marshal.ThrowExceptionForHR 方法

定义

用特定的失败 HRESULT 值引发异常。

重载

ThrowExceptionForHR(Int32)

用特定的失败 HRESULT 值引发异常。

ThrowExceptionForHR(Int32, IntPtr)

基于指定的 IErrorInfo 接口,用特定的失败 HRESULT 引发异常。

ThrowExceptionForHR(Int32)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

用特定的失败 HRESULT 值引发异常。

public:
 static void ThrowExceptionForHR(int errorCode);
[System.Security.SecurityCritical]
public static void ThrowExceptionForHR (int errorCode);
public static void ThrowExceptionForHR (int errorCode);
[<System.Security.SecurityCritical>]
static member ThrowExceptionForHR : int -> unit
static member ThrowExceptionForHR : int -> unit
Public Shared Sub ThrowExceptionForHR (errorCode As Integer)

参数

errorCode
Int32

与所需异常相对应的 HRESULT。

属性

注解

此方法为指定的失败 HRESULT 创建异常对象。 如果 HRESULT 为 0 或正 (成功代码) ,则该方法将返回,而不会创建或引发异常。

请注意, ThrowExceptionForHR(Int32) 如果设置了一个,方法会基于当前线程的 IErrorInfo 接口返回异常。 发生这种情况时, errorCode 将忽略 参数。

某些故障 HRESULT 映射到定义的异常,而其他故障则映射到定义的异常。 如果 HRESULT 映射到定义的异常, ThrowExceptionForHR 则创建异常的实例并引发它。 否则,它会创建 的 COMException实例,使用 HRESULT 初始化错误代码字段,并引发该异常。 调用 时 ThrowExceptionForHR ,它会尝试使用非托管 GetErrorInfo 函数检索有关错误的额外信息。

有关从每个 HRESULT 到 .NET Framework 中可比较异常类的映射,请参阅 如何:映射 HRESULT 和异常

有时, ThrowExceptionForHR 可能会从以前的 COM 调用返回异常。 在这种情况下,可以使用以下解决方法,并作为第二个参数传递 IntPtr(-1) (errorInfo) :

public static void ThrowExceptionForHR(interrorCode,IntPtrerrorInfo)

另请参阅

适用于

ThrowExceptionForHR(Int32, IntPtr)

Source:
Marshal.cs
Source:
Marshal.cs
Source:
Marshal.cs

基于指定的 IErrorInfo 接口,用特定的失败 HRESULT 引发异常。

public:
 static void ThrowExceptionForHR(int errorCode, IntPtr errorInfo);
[System.Security.SecurityCritical]
public static void ThrowExceptionForHR (int errorCode, IntPtr errorInfo);
public static void ThrowExceptionForHR (int errorCode, IntPtr errorInfo);
[<System.Security.SecurityCritical>]
static member ThrowExceptionForHR : int * nativeint -> unit
static member ThrowExceptionForHR : int * nativeint -> unit
Public Shared Sub ThrowExceptionForHR (errorCode As Integer, errorInfo As IntPtr)

参数

errorCode
Int32

与所需异常相对应的 HRESULT。

errorInfo
IntPtr

nativeint

指向 IErrorInfo 接口的指针,该接口提供有关错误的详细信息。 你可以指定 IntPtr(0) 以使用当前的 IErrorInfo 接口,或者 IntPtr(-1) 以忽略当前的 IErrorInfo 接口,并仅从错误代码构造异常。

属性

注解

此方法为指定的失败 HRESULT 创建异常对象。 如果 HRESULT 为 0 或正 (成功代码) ,则该方法将返回,而不会创建或引发异常。

方法 ThrowExceptionForHR 释放 errorInfo 参数,减少 IErrorInfo 接口的 COM 引用计数。

请注意, ThrowExceptionForHR 如果设置了一个,方法会基于当前线程的 IErrorInfo 接口返回异常。 发生这种情况时, errorCode 将忽略 参数。

某些故障 HRESULT 映射到定义的异常,而其他故障则映射到定义的异常。 如果 HRESULT 映射到定义的异常, ThrowExceptionForHR 则创建异常的实例并引发它。 否则,它会创建 的 System.Runtime.InteropServices.COMException实例,使用 HRESULT 初始化错误代码字段,并引发该异常。 参数 errorInfo 用于检索有关错误的额外信息。

有关从每个 HRESULT 到 .NET Framework 中可比较异常类的映射,请参阅 如何:映射 HRESULT 和异常

另请参阅

适用于