CriticalHandleZeroOrMinusOneIsInvalid.IsInvalid プロパティ

.NET Framework クラス ライブラリ リファレンス

CriticalHandleZeroOrMinusOneIsInvalid.IsInvalid プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ハンドルが無効かどうかを示す値を取得します。

名前空間: Microsoft.Win32.SafeHandles
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Overrides ReadOnly
 Property IsInvalid As Boolean

Visual Basic (使用法)

Dim instance As CriticalHandleZeroOrMinusOneIsInvalid
Dim value As Boolean

value = instance.IsInvalid

C#

public override bool IsInvalid { get;
 }

C++

public:
virtual property bool IsInvalid {
    bool get () override;
}

J#

/** @property */
public boolean get_IsInvalid ()

JScript

public override function get
 IsInvalid () : boolean

プロパティ値
ハンドルが無効な場合は true。それ以外の場合は false。

解説

共通言語ランタイムでは、このプロパティを使用して、クリティカルな終了操作が必要かどうかを確認します。

使用例

CriticalHandleZeroOrMinusOneIsInvalid クラスから派生したクラスを作成する方法のコード例を次に示します。この例では、アンマネージ メモリへのポインタをラップするクラスを作成します。

Visual Basic

Imports System
Imports System.Security.Permissions
Imports System.Runtime.InteropServices
Imports Microsoft.Win32.SafeHandles



Class Example

    Public Shared Sub Main()

        Dim ptr As IntPtr = Marshal.AllocHGlobal(10)

        Console.WriteLine("Ten bytes of unmanaged memory allocated.")

        Dim memHabdle As New
 CriticalUnmanagedMemoryHandle(ptr)

        If memHabdle.IsInvalid Then
            Console.WriteLine("CriticalUnmanagedMemoryHandle is
 invalid!.")
        Else
            Console.WriteLine("CriticalUnmanagedMemoryHandle class
 initialized to unmanaged memory.")
        End If

        Console.ReadLine()

    End Sub
End Class




' Demand unmanaged code permission to use this class.
<SecurityPermission(SecurityAction.Demand, UnmanagedCode:=True)> _
NotInheritable Class CriticalUnmanagedMemoryHandle
    Inherits CriticalHandleZeroOrMinusOneIsInvalid


    ' Set the handle.
    Friend Sub New(ByVal
 preexistingHandle As IntPtr)
        SetHandle(preexistingHandle)

    End Sub


    ' Perform any specific actions to release the 
    ' handle in the ReleaseHandle method.
    ' Often, you need to use Pinvoke to make
    ' a call into the Win32 API to release the 
    ' handle. In this case, however, we can use
    ' the Marshal class to release the unmanaged
    ' memory.
    Protected Overrides Function
 ReleaseHandle() As Boolean
        ' "handle" is the internal
        ' value for the IntPtr handle.
        ' If the handle was set,
        ' free it. Return success.
        If handle <> IntPtr.Zero Then

            ' Free the handle.
            Marshal.FreeHGlobal(handle)

            ' Set the handle to zero.
            handle = IntPtr.Zero

            ' Return success.
            Return True
        End If

        ' Return false. 
        Return False

    End Function
End Class

C#

using System;
using System.Security.Permissions;
using System.Runtime.InteropServices;
using Microsoft.Win32.SafeHandles;

namespace CriticalHandleExamples
{
    class Example
    {
        public static void
 Main()
        {

            IntPtr ptr = Marshal.AllocHGlobal(10);

            Console.WriteLine("Ten bytes of unmanaged memory allocated.");

            CriticalUnmanagedMemoryHandle memHabdle = new CriticalUnmanagedMemoryHandle(ptr);

            if (memHabdle.IsInvalid)
            {
                Console.WriteLine("CriticalUnmanagedMemoryHandle is invalid!.");
            }
            else
            {
                Console.WriteLine("CriticalUnmanagedMemoryHandle class
 initialized to unmanaged memory.");
            }

            Console.ReadLine();
        }
    }




    // Demand unmanaged code permission to use this class.
    [SecurityPermission(SecurityAction.Demand, UnmanagedCode = true)]
    sealed class CriticalUnmanagedMemoryHandle : CriticalHandleZeroOrMinusOneIsInvalid
    {

        // Set the handle.
        internal CriticalUnmanagedMemoryHandle(IntPtr preexistingHandle)
        {
            SetHandle(preexistingHandle);
        }

        // Perform any specific actions to release the 
        // handle in the ReleaseHandle method.
        // Often, you need to use Pinvoke to make
        // a call into the Win32 API to release the 
        // handle. In this case, however, we can use
        // the Marshal class to release the unmanaged
        // memory.
        override protected bool ReleaseHandle()
        {
            // "handle" is the internal
            // value for the IntPtr handle.

            // If the handle was set,
            // free it. Return success.
            if (handle != IntPtr.Zero)
            {

                // Free the handle.
                Marshal.FreeHGlobal(handle);

                // Set the handle to zero.
                handle = IntPtr.Zero;

                // Return success.
                return true;

            }

            // Return false. 
            return false;

        }
    }
}

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。 LinkDemand (セキュリティ アクション)。 UnmanagedCode (関連する列挙体)
• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。 InheritanceDemand (セキュリティ アクション)。 UnmanagedCode (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
CriticalHandleZeroOrMinusOneIsInvalid クラス
CriticalHandleZeroOrMinusOneIsInvalid メンバ
Microsoft.Win32.SafeHandles 名前空間
CriticalHandle
IsInvalid