CriticalHandleZeroOrMinusOneIsInvalid クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

CriticalHandleZeroOrMinusOneIsInvalid クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

値 0 または -1 が無効なハンドルである Win32 クリティカルハンドルの実装の基本クラスを提供します。

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

Visual Basic (宣言)

Public MustInherit Class
 CriticalHandleZeroOrMinusOneIsInvalid
    Inherits CriticalHandle

Visual Basic (使用法)

Dim instance As CriticalHandleZeroOrMinusOneIsInvalid

public abstract class CriticalHandleZeroOrMinusOneIsInvalid
 : CriticalHandle

C++

public ref class CriticalHandleZeroOrMinusOneIsInvalid
 abstract : public CriticalHandle

public abstract class CriticalHandleZeroOrMinusOneIsInvalid
 extends CriticalHandle

JScript

public abstract class CriticalHandleZeroOrMinusOneIsInvalid
 extends CriticalHandle

解説

このクラスは System.Runtime.InteropServices.CriticalHandle クラスから派生したクラスです。このクラスは無効なハンドルの形式を記述します。たとえば、無効なハンドル値として -1 を使用するハンドルもあれば、0 を使用するハンドルもあります。このクラスからさらにファイルハンドルやレジストリハンドルなどへ派生して、さらなる特化が可能です。

既存のマネージラッパーを持たないアンマネージリソースをラップする必要があるときは、CriticalHandleZeroOrMinusOneIsInvalid クラスを使用します。

メモ
クリティカルハンドルのセキュリティおよびスレッドセーフに関する重要な情報については、CriticalHandle クラスのトピックを参照してください。

使用例

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

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;

        }
    }
}

継承階層

System.Object
   System.Runtime.ConstrainedExecution.CriticalFinalizerObject
     System.Runtime.InteropServices.CriticalHandle
      Microsoft.Win32.SafeHandles.CriticalHandleZeroOrMinusOneIsInvalid

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。