Partilhar via


Overlapped.Pack Método

Definição

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

NativeOverlapped*

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

NativeOverlapped*

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.

Aplica-se a