Compartilhar via


CWnd::OnCopyData

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 objeto de CWnd que estão enviando os dados.

  • pCopyDataStruct
    Um ponteiro a estrutura de COPYDATASTRUCT que contém os dados que estão sendo enviados.

Valor de retorno

Retorna Verdadeiro se o aplicativo com êxito de recepção recebe os dados. Caso contrário, retornará Falso.

Comentários

Os dados que estão sendo passadas não devem conter ponteiros ou outras referências a objetos não podem o aplicativo que recebe os dados.

Quando os dados são copiados, não devem ser modificados por outro segmento de processo enviando.

O aplicativo de recepção deve considerar os dados somente leitura. A estrutura apontada pelo parâmetro pCopyDataStruct é válido somente durante a transferência de dados; entretanto, o aplicativo de receptor não deve liberar memória associado com a estrutura.

Se o aplicativo de recepção precisa de acesso a dados após essa função retorna, deve copiar os dados recebidos a um buffer local.

Dica

Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipule uma mensagem do windows.Parâmetros passados à sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi colocada.Se você chamar a implementação da classe base de essa função, essa implementação usará parâmetros passados originalmente com a mensagem e não os parâmetros que você fornece para a função.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

WM_COPYDATA