Overlapped.Pack Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Empacota a instância atual em uma estrutura NativeOverlapped.
Sobrecargas
| Pack(IOCompletionCallback) |
Obsoleto.
Obsoleto.
Obsoleto.
Obsoleto.
Empacota a instância atual em uma estrutura NativeOverlapped especificando o delegado a ser invocado quando a operação de E/S assíncrona é concluída. |
| Pack(IOCompletionCallback, Object) |
Empacota a instância atual em uma estrutura NativeOverlapped, especificando um delegado que é invocado quando a operação de E/S assíncrona é concluída e um objeto gerenciado que atua como um buffer. |
Pack(IOCompletionCallback)
Cuidado
This method is not safe. Use Pack (iocb, userData) instead. https://go.microsoft.com/fwlink/?linkid=14202
Cuidado
This overload is not safe and has been deprecated. Use Pack(IOCompletionCallback?, object?) instead.
Cuidado
This method is not safe. Use Pack (iocb, userData) instead. http://go.microsoft.com/fwlink/?linkid=14202
Cuidado
Use Pack(iocb, userData) instead
Importante
Esta API não está em conformidade com CLS.
Empacota a instância atual em uma estrutura NativeOverlapped especificando o delegado a ser invocado quando a operação de E/S assíncrona é concluída.
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>Parâmetros
- iocb
- IOCompletionCallback
Um delegado IOCompletionCallback que representa o método de retorno de chamada invocado quando a operação de E/S assíncrona é concluída.
Retornos
Um ponteiro não gerenciado para uma estrutura NativeOverlapped.
- Atributos
Exceções
O Overlapped atual já foi empacotado.
Comentários
O ponteiro não gerenciado retornado por esse método pode ser passado para o sistema operacional em operações de E/S sobrepostas. A NativeOverlapped estrutura é fixada na memória física até Unpack ser chamada.
Importante
O chamador é responsável por fixar o buffer. No entanto, se o domínio do aplicativo for descarregado, o identificador para o buffer fixado será destruído e o buffer será liberado, deixando a operação de E/S para gravar no endereço liberado. Por esse motivo, é melhor usar a sobrecarga do Pack(IOCompletionCallback, Object) método, na qual o runtime fixa o buffer.
Aplica-se a
Pack(IOCompletionCallback, Object)
Importante
Esta API não está em conformidade com CLS.
Empacota a instância atual em uma estrutura NativeOverlapped, especificando um delegado que é invocado quando a operação de E/S assíncrona é concluída e um objeto gerenciado que atua como um buffer.
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>Parâmetros
- iocb
- IOCompletionCallback
Um delegado IOCompletionCallback que representa o método de retorno de chamada invocado quando a operação de E/S assíncrona é concluída.
- userData
- Object
Um objeto ou uma matriz de objetos que representa o buffer de entrada ou de saída da operação. Cada objeto representa um buffer, por exemplo, uma matriz de bytes.
Retornos
Um ponteiro não gerenciado para uma estrutura NativeOverlapped.
- Atributos
Exceções
O Overlapped atual já foi empacotado.
Comentários
O ponteiro não gerenciado retornado por esse método pode ser passado para o sistema operacional em operações de E/S sobrepostas. A NativeOverlapped estrutura é fixada na memória física até Unpack ser chamada.
O buffer ou buffers especificados userData devem ser os mesmos passados para a função de sistema operacional não gerenciada que executa a E/S assíncrona.
Observação
O runtime fixa o buffer ou buffers especificados userData durante a operação de E/S. Se o domínio do aplicativo for descarregado, o runtime manterá a memória fixada até que a operação de E/S seja concluída.