WM_SYSCOPYDATA (Windows Embedded CE 6.0)

1/6/2010

This message is sent when a system component sends data to another system component. The WM_SYSCOPYDATA message provides a means for system components to transfer defined data types in process or cross process.

Syntax

WM_SYSCOPYDATA wParam = (WPARAM);
    lParam = (LPARAM)(PCOPYDATASTRUCT) pcds;

Parameters

• wParam
  A defined data type. Currently, WMSCD_CHAR_RANKED_ALTS is the only defined type.

• pcds
  Pointer to a COPYDATASTRUCT structure that contains the data to be passed.

Return Value

If the receiving component processes this message it should return TRUE, otherwise it should return FALSE.

Remarks

The WM_SYSCOPYDATA message has no counterpart on Windows-based desktop platforms. WM_SYSCOPYDATA is reserved for use by system components, such as modules that provide functionality integral to the Windows Embedded CE device and are built into the OS system image. Handwriting recognition engines and input panels are examples of system components that might use WM_SYSCOPYDATA.

All of the constraints outlined for WM_COPYDATA apply to WM_SYSCOPYDATA. For example, referenced data may not be changed while this message is being sent.

Applications that need the ability to transfer data in process or cross process should use WM_COPYDATA.

When the shell needs to resize a dialog box subsequent to a screen rotation and needs the dialog box client area to be viewable by scrolling, the shell should send a WM_SYSCOPYDATA message to the GWES dialog manager. When the GWES dialog manager receives this message, it will add or remove a vertical scrollbar to or from the dialog box. This functionality is available in Windows CE 5.0 and later.

Requirements

See Also

Reference

Interprocess Communication Messages
WM_COPYDATA
COPYDATASTRUCT