Overlapped.Pack Метод

  • Ссылка

Определение

Пространство имен:
System.Threading
Сборка:
System.Threading.Overlapped.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Упаковывает текущий экземпляр в структуру NativeOverlapped.

Перегрузки

Pack(IOCompletionCallback)
Является устаревшей.
Является устаревшей.
Является устаревшей.
Является устаревшей.

Помещает текущий экземпляр в структуру NativeOverlapped, определяющую делегата, вызываемого при завершении асинхронной операции ввода-вывода.
Pack(IOCompletionCallback, Object)

Помещает текущий экземпляр в структуру NativeOverlapped, определяющую делегата, вызываемого при завершении асинхронной операции ввода-вывода, и управляемый объект, который служит буфером.

Pack(IOCompletionCallback)

Внимание!

This method is not safe. Use Pack (iocb, userData) instead. https://go.microsoft.com/fwlink/?linkid=14202

Внимание!

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

Внимание!

This method is not safe. Use Pack (iocb, userData) instead. http://go.microsoft.com/fwlink/?linkid=14202

Внимание!

Use Pack(iocb, userData) instead

Важно!

Этот API несовместим с CLS.

Помещает текущий экземпляр в структуру NativeOverlapped, определяющую делегата, вызываемого при завершении асинхронной операции ввода-вывода.

public:
 System::Threading::NativeOverlapped* Pack(System::Threading::IOCompletionCallback ^ iocb);
[System.CLSCompliant(false)]
[System.Obsolete("This method is not safe.  Use Pack (iocb, userData) instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback? iocb);
[System.CLSCompliant(false)]
[System.Obsolete("This overload is not safe and has been deprecated. Use Pack(IOCompletionCallback?, object?) instead.")]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback? iocb);
[System.CLSCompliant(false)]
[System.Obsolete("This method is not safe.  Use Pack (iocb, userData) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback iocb);
[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback iocb);
[System.CLSCompliant(false)]
[System.Obsolete("This method is not safe.  Use Pack (iocb, userData) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
[System.Security.SecurityCritical]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback iocb);
[System.CLSCompliant(false)]
[System.Obsolete("This method is not safe.  Use Pack (iocb, userData) instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback iocb);
[System.CLSCompliant(false)]
[System.Obsolete("Use Pack(iocb, userData) instead")]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback iocb);
[<System.CLSCompliant(false)>]
[<System.Obsolete("This method is not safe.  Use Pack (iocb, userData) instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
member this.Pack : System.Threading.IOCompletionCallback -> nativeptr<System.Threading.NativeOverlapped>
[<System.CLSCompliant(false)>]
[<System.Obsolete("This overload is not safe and has been deprecated. Use Pack(IOCompletionCallback?, object?) instead.")>]
member this.Pack : System.Threading.IOCompletionCallback -> nativeptr<System.Threading.NativeOverlapped>
[<System.CLSCompliant(false)>]
[<System.Obsolete("This method is not safe.  Use Pack (iocb, userData) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
member this.Pack : System.Threading.IOCompletionCallback -> nativeptr<System.Threading.NativeOverlapped>
[<System.CLSCompliant(false)>]
member this.Pack : System.Threading.IOCompletionCallback -> nativeptr<System.Threading.NativeOverlapped>
[<System.CLSCompliant(false)>]
[<System.Obsolete("This method is not safe.  Use Pack (iocb, userData) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
[<System.Security.SecurityCritical>]
member this.Pack : System.Threading.IOCompletionCallback -> nativeptr<System.Threading.NativeOverlapped>
[<System.CLSCompliant(false)>]
[<System.Obsolete("Use Pack(iocb, userData) instead")>]
member this.Pack : System.Threading.IOCompletionCallback -> nativeptr<System.Threading.NativeOverlapped>

Параметры

iocb
IOCompletionCallback

Делегат IOCompletionCallback, который представляет метод обратного вызова, когда асинхронная операция ввода-вывода завершается.

Возвращаемое значение

NativeOverlapped*

Неуправляемый указатель на структуру NativeOverlapped.

Атрибуты
CLSCompliantAttribute ObsoleteAttribute SecurityCriticalAttribute

Исключения

InvalidOperationException

Текущий объект Overlapped уже упакован.

Комментарии

Неуправляемый указатель, возвращаемый этим методом, можно передать операционной системе в перекрывающихся операциях ввода-вывода. Структура NativeOverlapped фиксируется в физической памяти до тех пор, пока Unpack не будет вызвана.

Важно!

Вызывающий объект отвечает за закрепление буфера. Однако если домен приложения выгружается, дескриптор закрепленного буфера уничтожается и буфер освобождается, оставляя операцию ввода-вывода для записи в освобожденный адрес. По этой причине лучше использовать перегрузку Pack(IOCompletionCallback, Object) метода, в которой среда выполнения закрепляет буфер.

Применяется к

Pack(IOCompletionCallback, Object)

Важно!

Этот API несовместим с CLS.

Помещает текущий экземпляр в структуру NativeOverlapped, определяющую делегата, вызываемого при завершении асинхронной операции ввода-вывода, и управляемый объект, который служит буфером.

public:
 System::Threading::NativeOverlapped* Pack(System::Threading::IOCompletionCallback ^ iocb, System::Object ^ userData);
[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback? iocb, object? userData);
[System.CLSCompliant(false)]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback iocb, object userData);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback iocb, object userData);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public System.Threading.NativeOverlapped* Pack (System.Threading.IOCompletionCallback iocb, object userData);
[<System.CLSCompliant(false)>]
member this.Pack : System.Threading.IOCompletionCallback * obj -> nativeptr<System.Threading.NativeOverlapped>
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Pack : System.Threading.IOCompletionCallback * obj -> nativeptr<System.Threading.NativeOverlapped>
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
member this.Pack : System.Threading.IOCompletionCallback * obj -> nativeptr<System.Threading.NativeOverlapped>

Параметры

iocb
IOCompletionCallback

Делегат IOCompletionCallback, который представляет метод обратного вызова, когда асинхронная операция ввода-вывода завершается.

userData
Object

Объект или массив объектов, представляющие буфер ввода или вывода для данной операции. Каждый объект представляет буфер, например, массив байтов.

Возвращаемое значение

NativeOverlapped*

Неуправляемый указатель на структуру NativeOverlapped.

Атрибуты
CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Исключения

InvalidOperationException

Текущий объект Overlapped уже упакован.

Комментарии

Неуправляемый указатель, возвращаемый этим методом, можно передать операционной системе в перекрывающихся операциях ввода-вывода. Структура NativeOverlapped фиксируется в физической памяти до тех пор, пока Unpack не будет вызвана.

Буфер или буферы, указанные в userData , должны совпадать с теми, которые передаются в неуправляемую функцию операционной системы, которая выполняет асинхронный ввод-вывод.

Примечание

Среда выполнения закрепляет буфер или буферы, указанные в userData течение операции ввода-вывода. Если домен приложения выгружается, среда выполнения сохраняет закрепленную память до завершения операции ввода-вывода.

Применяется к