SafeHandle.SetHandle

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

SafeHandle.SetHandle メソッド

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

ハンドルを指定した既存のハンドルに設定します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Protected Sub SetHandle ( _
    handle As IntPtr _
)

Visual Basic (使用法)

Dim handle As IntPtr

Me.SetHandle(handle)

C#

protected void SetHandle (
    IntPtr handle
)

C++

protected:
void SetHandle (
    IntPtr handle
)

J#

protected void SetHandle (
    IntPtr handle
)

JScript

protected function SetHandle (
    handle : IntPtr
)

パラメータ

handle

使用する既存のハンドル。

解説

SetHandle メソッドは、既存のハンドルをサポートする必要がある場合にだけ (構造体でハンドルが返される場合など) 使用します。.NET Framework の COM 相互運用インフラストラクチャでは、構造体での出力ハンドルのマーシャリングをサポートしていないためです。

使用例

SetHandle メソッドを実装する方法の例を次に示します。ハンドルを指定した既存のハンドルに確実に設定するには、ネイティブ ハンドルの割り当てと SafeHandle オブジェクト内でのそのハンドルの以降の記録を必ず分離不可能な状態にすることが必要です。これらの操作間でエラーが発生すると (スレッドの中止やメモリ不足の例外によるエラーなど)、ネイティブ ハンドルがリークされることになります。このコード例では、制約された実行領域を使用して信頼性を実現する方法を示しています。

Visual Basic

<StructLayout(LayoutKind.Sequential)> _
Structure MyStruct
    Public m_outputHandle As IntPtr
End Structure 'MyStruct


NotInheritable Class MySafeHandle
    Inherits SafeHandle

    ' Called by P/Invoke when returning SafeHandles
    Public Sub New()
        MyBase.New(IntPtr.Zero, True)

    End Sub


    Public Function AllocateHandle() As
 MySafeHandle
        ' Allocate SafeHandle first to avoid failure later.
        Dim sh As New MySafeHandle()

        RuntimeHelpers.PrepareConstrainedRegions()
        Try
        Finally
            Dim myStruct As New
 MyStruct()
            NativeAllocateHandle(myStruct)
            sh.SetHandle(myStruct.m_outputHandle)
        End Try

        Return sh

    End Function

C#

[StructLayout(LayoutKind.Sequential)]
struct MyStruct
{
    public IntPtr m_outputHandle;
}

sealed class MySafeHandle : SafeHandle
{
    // Called by P/Invoke when returning SafeHandles
    public MySafeHandle()
        : base(IntPtr.Zero, true)
    {
    }

    public MySafeHandle AllocateHandle()
    {
        // Allocate SafeHandle first to avoid failure later.
        MySafeHandle sh = new MySafeHandle();

        RuntimeHelpers.PrepareConstrainedRegions();
        try { }
        finally
        {
            MyStruct myStruct = new MyStruct();
            NativeAllocateHandle(ref myStruct);
            sh.SetHandle(myStruct.m_outputHandle);
        }

        return sh;
    }

.NET Framework のセキュリティ

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

プラットフォーム

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

参照

関連項目
SafeHandle クラス
SafeHandle メンバ
System.Runtime.InteropServices 名前空間

SafeHandle.SetHandle メソッド

名前空間: System.Security.Cryptography
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Protected Sub SetHandle ( _
    handle As IntPtr _
)

Visual Basic (使用法)

Dim handle As IntPtr

Me.SetHandle(handle)

C#

protected void SetHandle (
    IntPtr handle
)

C++

protected:
void SetHandle (
    IntPtr handle
)

J#

protected void SetHandle (
    IntPtr handle
)

JScript

protected function SetHandle (
    handle : IntPtr
)

パラメータ

handle

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

バージョン情報

.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SafeHandle クラス
SafeHandle メンバ
System.Security.Cryptography 名前空間