Marshal.ThrowExceptionForHR 方法

定义

命名空间:

System.Runtime.InteropServices

程序集:

System.Runtime.InteropServices.dll

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

重载

ThrowExceptionForHR(Int32)	用特定的失败 HRESULT 值引发异常。
ThrowExceptionForHR(Int32, IntPtr)	基于指定的 IErrorInfo 接口，用特定的失败 HRESULT 引发异常。

ThrowExceptionForHR(Int32)

Source:

Marshal.cs

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

public:
 static void ThrowExceptionForHR(int errorCode);

public static void ThrowExceptionForHR (int errorCode);

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)

另请参阅

• COMException

ThrowExceptionForHR(Int32, IntPtr)

Source:

Marshal.cs

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

public:
 static void ThrowExceptionForHR(int errorCode, IntPtr errorInfo);

public static void ThrowExceptionForHR (int errorCode, IntPtr errorInfo);

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 和异常。

另请参阅

• COMException