CWnd::OnCopyData

Artigo
08/25/2010

Essa função de membro é chamada pela estrutura para copiar dados de um aplicativo para outro.

afx_msg BOOL OnCopyData(
   CWnd* pWnd,
   COPYDATASTRUCT* pCopyDataStruct 
);

Parâmetros

pWnd
Um ponteiro para um CWnd objeto que está enviando os dados.
pCopyDataStruct
Um ponteiro para um COPYDATASTRUCT estrutura que contém os dados enviados.

Valor de retorno

RetornaTRUE se o aplicativo de recebimento aceita com êxito os dados.Caso contrário, retornará FALSE.

Comentários

Os dados sendo passados não devem conter ponteiros ou outras referências a objetos não está acessíveis para o aplicativo recebendo os dados.

Enquanto está sendo copiados os dados, ele não deve ser alterado por outro segmento do processo de envio.

O aplicativo de recebimento deve considerar os dados somente leitura.A estrutura apontado pelo parâmetro pCopyDataStruct é válido apenas durante a transferência de dados; no entanto, o aplicativo de recebimento não deve liberar a memória associada com a estrutura.

Se o aplicativo de recebimento precisa acessar os dados depois que esta função retorna, ele deverá copiar os dados recebidos para um buffer local.

Observação:
Essa função de membro é chamada pela estrutura para permitir que seu applic informações para lidar com uma mensagem do Windows.Os parâmetros passados para sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi recebida.Se você chamar a implementação da classe de base dessa função, essa implementação usará o parâmetro s originalmente passados com a mensagem e não os parâmetros que você fornecer para a função.

Essa função de membro é chamada pela estrutura para permitir que seu applic informações para lidar com uma mensagem do Windows.Os parâmetros passados para sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi recebida.Se você chamar a implementação da classe de base dessa função, essa implementação usará o parâmetro s originalmente passados com a mensagem e não os parâmetros que você fornecer para a função.