WM_CAP_FILE_SAVEAS
The
WM_CAP_FILE_SAVEAS message copies the contents of the capture file to another
file. You can send this message explicitly or by using the capFileSaveAs macro.
WM_CAP_FILE_SAVEAS
wParam = (WPARAM) 0;
lParam = (LPARAM) (LPVOID) (LPSTR) (szName);
Parameters
szName
Address of
the null-terminated string that contains the name of the destination file used
to copy the file.
Return Values
Returns TRUE
if successful or FALSE otherwise.
If an error
occurs and an error callback function is set using the WM_CAP_SET_CALLBACK_ERROR message, the error callback
function is called.
Remarks
This message
does not change the name or contents of the current capture file.
If the copy
operation is unsuccessful due to a disk full error, the destination file is
automatically deleted.
Typically, a
capture file is preallocated for the largest capture segment anticipated and
only a portion of it might be used to capture data. This message copies only
the portion of the file containing the capture data.
See Also