SafeHandleZeroOrMinusOneIsInvalid SafeHandleZeroOrMinusOneIsInvalid SafeHandleZeroOrMinusOneIsInvalid SafeHandleZeroOrMinusOneIsInvalid Class


0 또는 -1 값이 잘못된 핸들을 나타내는 Win32 SafeHandle 구현에 대한 기본 클래스를 제공합니다.Provides a base class for Win32 safe handle implementations in which the value of either 0 or -1 indicates an invalid handle.

public ref class SafeHandleZeroOrMinusOneIsInvalid abstract : System::Runtime::InteropServices::SafeHandle
public abstract class SafeHandleZeroOrMinusOneIsInvalid : System.Runtime.InteropServices.SafeHandle
type SafeHandleZeroOrMinusOneIsInvalid = class
    inherit SafeHandle
Public MustInherit Class SafeHandleZeroOrMinusOneIsInvalid
Inherits SafeHandle


이 클래스는 System.Runtime.InteropServices.SafeHandle 클래스에서 파생됩니다.This class derives from the System.Runtime.InteropServices.SafeHandle class. 잘못 된 핸들의 형식을 설명 합니다.It describes the format of an invalid handle. 예를 들어, 일부 처리-1 잘못 된 핸들 값을 사용 하 고 다른 0를 사용 합니다.For example, some handles use -1 as an invalid handle value, while others use 0. (예: 파일, 레지스트리 핸들)에 대 한이 클래스의 추가 파생이 추가로 특수화할 수 있습니다.Further derivations of this class (for example, file or registry handles) can specialize this further. 참조 된 SafeFileHandle 클래스에서 파생 된 클래스의 예로 SafeHandleZeroOrMinusOneIsInvalid합니다.See the SafeFileHandle class for an example of a class that derives from SafeHandleZeroOrMinusOneIsInvalid.


이 형식이 구현 하는 IDisposable 인터페이스입니다.This type implements the IDisposable interface. 형식을 사용 하 여 마쳤으면 직접 또는 간접적으로의 삭제 해야 있습니다.When you have finished using the type, you should dispose of it either directly or indirectly. 직접 형식의 dispose 호출 해당 Dispose 의 메서드를 try / catch 블록입니다.To dispose of the type directly, call its Dispose method in a try/catch block. 삭제 하지 직접, 언어 구문 같은 사용 using (C#에서) 또는 Using (Visual Basic에서는).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). 자세한 내용은 "를 사용 하는 개체는 구현 IDisposable" 섹션을 참조 하세요.를 IDisposable 인터페이스 항목입니다.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

사용 하 여는 SafeHandleZeroOrMinusOneIsInvalid 되지 않은 기존 관리 되지 않는 리소스를 안전 하 게 래핑할 필요할 때마다 클래스 래퍼를 관리 합니다.Use the SafeHandleZeroOrMinusOneIsInvalid class whenever you need to safely wrap an unmanaged resource that does not have an existing managed wrapper.


SafeHandleZeroOrMinusOneIsInvalid(Boolean) SafeHandleZeroOrMinusOneIsInvalid(Boolean) SafeHandleZeroOrMinusOneIsInvalid(Boolean) SafeHandleZeroOrMinusOneIsInvalid(Boolean)

핸들을 안정적으로 해제할지 여부를 지정하여 SafeHandleZeroOrMinusOneIsInvalid 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the SafeHandleZeroOrMinusOneIsInvalid class, specifying whether the handle is to be reliably released.


IsClosed IsClosed IsClosed IsClosed

핸들이 닫혔는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the handle is closed.

(Inherited from SafeHandle)
IsInvalid IsInvalid IsInvalid IsInvalid

핸들이 잘못되었는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the handle is invalid.


Close() Close() Close() Close()

핸들의 리소스를 해제하도록 표시합니다.Marks the handle for releasing and freeing resources.

(Inherited from SafeHandle)
DangerousAddRef(Boolean) DangerousAddRef(Boolean) DangerousAddRef(Boolean) DangerousAddRef(Boolean)

SafeHandle 인스턴스의 참조 카운터의 값을 수동으로 증가시킵니다.Manually increments the reference counter on SafeHandle instances.

(Inherited from SafeHandle)
DangerousGetHandle() DangerousGetHandle() DangerousGetHandle() DangerousGetHandle()

handle 필드의 값을 반환합니다.Returns the value of the handle field.

(Inherited from SafeHandle)
DangerousRelease() DangerousRelease() DangerousRelease() DangerousRelease()

SafeHandle 인스턴스의 참조 카운터의 값을 수동으로 감소시킵니다.Manually decrements the reference counter on a SafeHandle instance.

(Inherited from SafeHandle)
Dispose() Dispose() Dispose() Dispose()

SafeHandle 클래스에서 사용하는 모든 리소스를 해제합니다.Releases all resources used by the SafeHandle class.

(Inherited from SafeHandle)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

일반적인 삭제 작업을 수행할지 여부를 지정하여 SafeHandle 클래스에서 사용하는 관리되지 않는 리소스를 해제합니다.Releases the unmanaged resources used by the SafeHandle class specifying whether to perform a normal dispose operation.

(Inherited from SafeHandle)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
ReleaseHandle() ReleaseHandle() ReleaseHandle() ReleaseHandle()

파생 클래스에서 재정의된 경우 핸들을 해제하는 데 필요한 코드를 실행합니다.When overridden in a derived class, executes the code required to free the handle.

(Inherited from SafeHandle)
SetHandle(IntPtr) SetHandle(IntPtr) SetHandle(IntPtr) SetHandle(IntPtr)

지정된 기존 핸들에 대한 핸들을 설정합니다.Sets the handle to the specified pre-existing handle.

(Inherited from SafeHandle)
SetHandleAsInvalid() SetHandleAsInvalid() SetHandleAsInvalid() SetHandleAsInvalid()

더 이상 사용되지 않는 핸들로 표시합니다.Marks a handle as no longer used.

(Inherited from SafeHandle)
ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)


handle handle handle handle

래핑할 핸들을 지정합니다.Specifies the handle to be wrapped.

(Inherited from SafeHandle)


상속자의 경우 완전히 신뢰합니다.for full trust for inheritors. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 상속할 수 없습니다.This member cannot be inherited by partially trusted code.

직접 실행 호출자에 대 한 완전 신뢰가 필요 합니다.requires full trust for the immediate caller. 이 멤버는 부분적으로 신뢰할 수 있는 또는 투명 코드에서 사용할 수 없습니다.This member cannot be used by partially trusted or transparent code.

적용 대상

추가 정보