capFileSaveAs
The capFileSaveAs
macro copies the contents of the capture file to another file. You can use this
macro or explicitly call the WM_CAP_FILE_SAVEASE4RDVZ message.
BOOL capFileSaveAs(
|
hwnd, |
|
|
szName |
|
|
); |
|
Parameters
hwnd
Handle of a
capture window.
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 capSetCallbackOnError macro, 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