CriticalHandle.SetHandleAsInvalid メソッド

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

CriticalHandle.SetHandleAsInvalid メソッド

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

ハンドルを無効としてマークします。

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

Visual Basic (宣言)

Public Sub SetHandleAsInvalid

Visual Basic (使用法)

Dim instance As CriticalHandle

instance.SetHandleAsInvalid

C#

public void SetHandleAsInvalid ()

C++

public:
void SetHandleAsInvalid ()

J#

public void SetHandleAsInvalid ()

JScript

public function SetHandleAsInvalid ()

解説

SetHandleAsInvalid メソッドは、ハンドルが無効であることが判明しており、無効であるとマークを付ける場合のみ呼び出します。このメソッドを呼び出しても、handle フィールドの値は変更されません。ハンドルのみを無効としてマークします。このため、ハンドルには古い値が格納されている可能性があります。このメソッドを呼び出しても、リソースを解放する試みは行われません。

SetHandle メソッドと同様に、SetHandleAsInvalid は既存のハンドルをサポートする必要がある場合にだけ使用します。

.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

参照

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