Marshal.ThrowExceptionForHR 方法

  • 参考

定义

命名空间:
System.Runtime.InteropServices
程序集:
System.Runtime.InteropServices.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll

用特定的失败 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。

属性
SecurityCriticalAttribute

注解

此方法为指定的失败 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 接口，并仅从错误代码构造异常。

属性
SecurityCriticalAttribute

注解

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

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

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

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

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

另请参阅

适用于