Overlapped.UnsafePack メソッド

定義

名前空間:

System.Threading

アセンブリ:

System.Threading.Overlapped.dll

現在のインスタンスを NativeOverlapped 構造体にパックします。 コール スタックは反映しません。

オーバーロード

UnsafePack(IOCompletionCallback)	古い. 非同期 I/O 操作が完了したときに呼び出すデリゲートを指定して、現在のインスタンスを NativeOverlapped 構造体にパックします。 コール スタックは反映しません。
UnsafePack(IOCompletionCallback, Object)	非同期 I/O 操作が完了したときに呼び出すデリゲートと、バッファーとして機能するマネージド オブジェクトを指定して、現在のインスタンスを NativeOverlapped 構造体にパックします。 コール スタックは反映しません。

UnsafePack(IOCompletionCallback)

ソース:

Overlapped.cs

注意事項

This overload is not safe and has been deprecated. Use UnsafePack(IOCompletionCallback?, object?) instead.

重要

この API は CLS 準拠ではありません。

非同期 I/O 操作が完了したときに呼び出すデリゲートを指定して、現在のインスタンスを NativeOverlapped 構造体にパックします。 コール スタックは反映しません。

public:
 System::Threading::NativeOverlapped* UnsafePack(System::Threading::IOCompletionCallback ^ iocb);

[System.CLSCompliant(false)]
[System.Obsolete("This overload is not safe and has been deprecated. Use UnsafePack(IOCompletionCallback?, object?) instead.")]
public System.Threading.NativeOverlapped* UnsafePack (System.Threading.IOCompletionCallback? iocb);

[<System.CLSCompliant(false)>]
[<System.Obsolete("This overload is not safe and has been deprecated. Use UnsafePack(IOCompletionCallback?, object?) instead.")>]
member this.UnsafePack : System.Threading.IOCompletionCallback -> nativeptr<System.Threading.NativeOverlapped>

パラメーター

iocb

IOCompletionCallback

非同期 I/O 操作が完了したときに呼び出すコールバック メソッドを表す IOCompletionCallback デリゲート。

戻り値

NativeOverlapped*

NativeOverlapped 構造体へのアンマネージ ポインター。

属性

CLSCompliantAttribute ObsoleteAttribute

例外

InvalidOperationException

現在の Overlapped は既にパックされています。

注釈

このメソッドによって返されるアンマネージ ポインターは、重複した I/O 操作でオペレーティング システムに渡すことができます。 構造体は NativeOverlapped 、 が呼び出されるまで Unpack 物理メモリ内で固定されます。

呼び出し元は、バッファーのピン留めします。 ただし、アプリケーション ドメインがアンロードされた場合は、固定されたバッファーへのハンドルが破棄されて、バッファーが解放され、解放されたアドレスへ書き込むための I/O 操作が残ります。 このため、ランタイムがバッファーをピン留めする UnsafePack(IOCompletionCallback, Object)メソッド オーバーロードを使用することをお勧めします。

注意事項

メソッドを UnsafePack 使用すると、誤ってセキュリティ ホールが開く可能性があります。 コード アクセス セキュリティは、スタック上のすべての呼び出し元のアクセス許可に対するアクセス許可チェックに基づいて行います。 メソッドは UnsafePack 呼び出し元のスタックを伝達しません。 悪意のあるコードでは、これを悪用してアクセス許可チェックを回避できる可能性があります。

UnsafePack(IOCompletionCallback, Object)

ソース:

Overlapped.cs

重要

この API は CLS 準拠ではありません。

非同期 I/O 操作が完了したときに呼び出すデリゲートと、バッファーとして機能するマネージド オブジェクトを指定して、現在のインスタンスを NativeOverlapped 構造体にパックします。 コール スタックは反映しません。

public:
 System::Threading::NativeOverlapped* UnsafePack(System::Threading::IOCompletionCallback ^ iocb, System::Object ^ userData);

[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* UnsafePack (System.Threading.IOCompletionCallback? iocb, object? userData);

[<System.CLSCompliant(false)>]
member this.UnsafePack : System.Threading.IOCompletionCallback * obj -> nativeptr<System.Threading.NativeOverlapped>

パラメーター

iocb

IOCompletionCallback

非同期 I/O 操作が完了したときに呼び出すコールバック メソッドを表す IOCompletionCallback デリゲート。

userData

Object

操作の入力バッファーまたは出力バッファーを表す、オブジェクトまたはオブジェクトの配列。 各オブジェクトが、バイトの配列などのバッファーを表します。

戻り値

NativeOverlapped*

NativeOverlapped 構造体へのアンマネージ ポインター。

属性

CLSCompliantAttribute

例外

SecurityException

呼び出し元に、必要なアクセス許可がありません。

InvalidOperationException

現在の Overlapped は既にパックされています。

注釈

このメソッドによって返されるアンマネージ ポインターは、重複した I/O 操作でオペレーティング システムに渡すことができます。 構造体は NativeOverlapped 、 が呼び出されるまで Unpack 物理メモリ内で固定されます。

で userData 指定されるバッファーは、非同期 I/O を実行するアンマネージド オペレーティング システム関数に渡されるものと同じである必要があります。

ランタイムは、 でuserData 指定されたバッファーを I/O 操作の間ピン留めします。 アプリケーション ドメインがアンロードされた場合、ランタイムは I/O 操作が完了するまでメモリを固定したままにします。

注意事項

メソッドを UnsafePack 使用すると、誤ってセキュリティ ホールが開く可能性があります。 コード アクセス セキュリティは、スタック上のすべての呼び出し元のアクセス許可に対するアクセス許可チェックに基づいて行います。 メソッドは UnsafePack 呼び出し元のスタックを伝達しません。 悪意のあるコードでは、これを悪用してアクセス許可チェックを回避できる可能性があります。