Overlapped.Pack Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Упаковывает текущий экземпляр в структуру 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.
- Атрибуты
Исключения
Текущий объект 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.
- Атрибуты
Исключения
Текущий объект Overlapped уже упакован.
Комментарии
Неуправляемый указатель, возвращаемый этим методом, можно передать операционной системе в перекрывающихся операциях ввода-вывода. Структура NativeOverlapped фиксируется в физической памяти до тех пор, пока Unpack не будет вызвана.
Буфер или буферы, указанные в userData
, должны совпадать с теми, которые передаются в неуправляемую функцию операционной системы, которая выполняет асинхронный ввод-вывод.
Примечание
Среда выполнения закрепляет буфер или буферы, указанные в userData
течение операции ввода-вывода. Если домен приложения выгружается, среда выполнения сохраняет закрепленную память до завершения операции ввода-вывода.