メソッドを呼び出さずに、一度だけ実行されるメソッド セットアップ タスクを実行します。
Public Shared Sub Prelink( _
ByVal m As MethodInfo _)
[C#]
public static void Prelink(MethodInfom);
[C++]
public: static void Prelink(MethodInfo* m);
[JScript]
public static function Prelink(
m : MethodInfo);
パラメータ
- m
確認するメソッドを識別する System.Reflection.MethodInfo 。
解説
セットアップ タスクでは、事前初期化を実行します。ターゲット メソッドの呼び出し時に自動的に実行されます。初回実行タスクには、次の処理が含まれます。
- プラットフォーム呼び出しのメタデータが正しく書式指定されているかどうかを検証する。
- すべてのマネージ型がプラットフォーム呼び出し関数の有効なパラメータかどうかを検証する。
- アンマネージ DLL を特定し、プロセスに読み込む。
- プロセスのエントリ ポイントを特定する。
プラットフォーム呼び出しの外部のメソッドで Prelink を呼び出しても、何も起こりません。ある型のすべてのプラットフォーム呼び出しメソッドでセットアップ タスクを実行するには、 Marshal.PrelinkAll を使用します。
メモ このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。 SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。 LinkDemand メンバの使用に関する重要な制約事項については、「 Demand と LinkDemand 」を参照してください。
使用例
[Visual Basic, C#] USER32.DLL の MessageBox 関数のプライベート静的プラットフォーム呼び出しシグネチャを持つインスタンスで Prelink を使用する例を次に示します。
' Get a MethodInfo for the Private Shared Sub
Dim mi As MethodInfo = obj.GetType().GetMethod("MessageBox", _
BindingFlags.Static Or BindingFlags.NonPublic)
' Call Prelink using the MethodInfo instance
Marshal.Prelink(mi)
[C#]
// Get a MethodInfo for the private static method
MethodInfo mi = obj.GetType().GetMethod("MessageBox",
BindingFlags.Static | BindingFlags.NonPublic);
// Call Prelink using the MethodInfo instance
Marshal.Prelink(mi);
[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- SecurityPermission (アンマネージ コードを操作するために必要なアクセス許可) SecurityPermissionFlag.UnmanagedCode (関連する列挙体)
参照
Marshal クラス | Marshal メンバ | System.Runtime.InteropServices 名前空間 | PrelinkAll | MethodInfo