CWnd::OnCopyData

Diese Memberfunktion wird vom Framework aufgerufen, um Daten von einer Anwendung in eine andere kopieren.

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

Parameter

  • pWnd
    Ein Zeiger auf einen CWnd-Objekt, das die Daten sendet.

  • pCopyDataStruct
    Ein Zeiger auf eine COPYDATASTRUCT-Struktur, die die Daten enthält, die gesendet werden.

Rückgabewert

Gibt TRUE zurück, wenn die empfangende Anwendung erfolgreich die Daten akzeptiert.Andernfalls gibt zurück FALSE.

Hinweise

Die Daten, die übergeben werden, dürfen Zeiger oder andere Verweise auf Objekte nicht enthalten, die für die Anwendung nicht zugänglich sind, die die Daten empfängt.

Während die Daten kopiert werden, darf es nicht durch einen anderen Thread des Prozesses sendenden geändert werden.

Die empfangende Anwendung sollte die Daten als schreibgeschützt berücksichtigen.Die Struktur, die durch den Parameter pCopyDataStruct gezeigt wird, ist nur während der Übertragung von Daten gültig; sollte jedoch die empfangende Anwendung den Arbeitsspeicher nicht nutzen, der mit der Struktur zugeordnet ist.

Wenn die empfangende Anwendung Zugriff auf die Daten benötigt werden, nachdem diese Funktion zurückgibt, muss sie die Daten kopieren, die zu einem lokalen Puffer empfangen werden.

HinweisHinweis

Diese Memberfunktion wird vom Framework aufgerufen, um die Anwendung zu ermöglichen, eine Windows-Meldung zu bearbeiten.Die Parameter, die an die Funktion übergeben werden, geben die Parameter, die vom Framework empfangen werden, als die Nachricht empfangen wurde.Wenn Sie die Basisklassenimplementierung dieser Funktion aufrufen, verwendet diese Implementierung die Parameter, die mit der Meldung übergeben werden und nicht die Parameter, die an die Funktion bereitstellen.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CWnd-Klasse

Hierarchien-Diagramm

WM_COPYDATA