SafeHandleZeroOrMinusOneIsInvalid 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
为 Win32 安全句柄实现提供基类，在这些实现中，值为 0 或 -1 都表示无效句柄。
public ref class SafeHandleZeroOrMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandlepublic abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle[System.Security.SecurityCritical]
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandletype SafeHandleZeroOrMinusOneIsInvalid = class
inherit SafeHandle[<System.Security.SecurityCritical>]
type SafeHandleZeroOrMinusOneIsInvalid = class
inherit SafeHandlePublic MustInherit Class SafeHandleZeroOrMinusOneIsInvalid
Inherits SafeHandle- 继承
- 派生
- 属性
注解
此类从 System.Runtime.InteropServices.SafeHandle 类派生。 它描述无效句柄的格式。 例如，某些句柄使用 -1 作为无效句柄值，而其他句柄使用 0。 此类的进一步派生 (例如，文件或注册表句柄) 可以进一步对此进行专用化。 SafeFileHandle有关派生自 SafeHandleZeroOrMinusOneIsInvalid的类的示例，请参阅 类。
重要
此类型实现 IDisposable 接口。 在使用完类型后，您应直接或间接释放类型。 若要直接释放类型，请在 try/catch 块中调用其 Dispose 方法。 若要间接释放类型，请使用 using（在 C# 中）或 Using（在 Visual Basic 中）等语言构造。 有关详细信息，请参阅 IDisposable 接口主题中的“使用实现 IDisposable 的对象”一节。
SafeHandleZeroOrMinusOneIsInvalid每当需要安全地包装没有现有托管包装器的非托管资源时，请使用 类。
构造函数
| SafeHandleZeroOrMinusOneIsInvalid(Boolean) |
初始化 SafeHandleZeroOrMinusOneIsInvalid 类的新实例，并指定是否要可靠地释放句柄。 |
字段
| handle |
指定要包装的句柄。 (继承自 SafeHandle) |
属性
| IsClosed |
获取一个值，该值指示句柄是否已关闭。 (继承自 SafeHandle) |
| IsInvalid |
获取一个值，该值指示句柄是否无效。 |
方法
| Close() |
标记句柄，以便释放资源。 (继承自 SafeHandle) |
| DangerousAddRef(Boolean) |
手动递增 SafeHandle 实例中的引用计数器。 (继承自 SafeHandle) |
| DangerousGetHandle() |
返回 handle 字段的值。 (继承自 SafeHandle) |
| DangerousRelease() |
手动递减 SafeHandle 实例中的引用计数器。 (继承自 SafeHandle) |
| Dispose() |
释放 SafeHandle 类使用的所有资源。 (继承自 SafeHandle) |
| Dispose(Boolean) |
释放 SafeHandle 类所使用的非托管资源，指定是否执行常规释放操作。 (继承自 SafeHandle) |
| Equals(Object) |
确定指定对象是否等于当前对象。 (继承自 Object) |
| GetHashCode() |
作为默认哈希函数。 (继承自 Object) |
| GetType() |
获取当前实例的 Type。 (继承自 Object) |
| MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
| ReleaseHandle() |
在派生类中重写时，执行释放句柄所需的代码。 (继承自 SafeHandle) |
| SetHandle(IntPtr) |
将句柄设置为预先存在的指定句柄。 (继承自 SafeHandle) |
| SetHandleAsInvalid() |
将句柄标记为不再使用。 (继承自 SafeHandle) |
| ToString() |
返回表示当前对象的字符串。 (继承自 Object) |
