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的类的示例，请参阅类。
Important
此类型实现 IDisposable 接口。 使用完该类型后，应直接或间接处理它。 若要直接释放类型，请在块中Disposetry/调用其catch方法。 若要间接释放它，请使用语言构造，例如 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) |
