This message removes the specified range of data from the device element and places it in the system clipboard or application-supplied buffer. The position of the media after a cut command is the FROM position, if MCI_FROM is specified. If MCI_FROM is not specified, the current position is used.

ulParam1 (ULONG)

This parameter can contain any of the following flags:

MCI_NOTIFY

A notification message will be posted to the window specified in the hwndCallback parameter of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
MCI_WAIT
Control is not to be returned until the action indicated by this message is completed or an error occurs.
MCI_FROM
The beginning position of a cut operation. The position of the media is either the position specified in the ulFrom field or the previous position if MCI_FROM is not specified.
MCI_TO
The ending position of a cut operation.
MCI_TO_BUFFER
Place the data from a file into an application-supplied buffer. If this flag is not specified, then the clipboard is used.

pParam2 (PMCI_EDIT_PARMS)

A pointer to the MCI_EDIT_PARMS data structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

Cut was successful.
MCIERR_INVALID_BUFFER
Buffer too small to hold data.
MCIERR_CANNOT_WRITE
The file was not opened with write access.
MCIERR_OUTOFRANGE
The units are out of the range.
MCIERR_INVALID_DEVICE_ID
The device ID is not valid.
MCIERR_MISSING_PARAMETER
Required parameter is missing.
MCIERR_INVALID_FLAG
Flag is invalid (ulParam1).
MCIERR_UNSUPPORTED_FLAG
Given flag is unsupported for this device.
MCIERR_INSTANCE_INACTIVE
The device is currently inactive. Issue MCI_ACQUIREDEVICE to make the device context active.
MCIERR_INVALID_CALLBACK_HANDLE
Given callback handle is invalid.
MCIERR_OUT_OF_MEMORY
There is insufficient memory to perform the requested operation.
MCIERR_CLIPBOARD_ERROR
An error occurred while attempting to access the clipboard.

---

[Back] [Next]