Captures a screen area of a remote virtual machine desktop and saves it to a file on the client machine.
Name and path of the file to save the image to.
Image quality factor. Must be in the range from 0 to 100, or -1. Specify 0 to use the highest data compression, 100 for no compression, and -1 for default.
The X coordinate of the upper-left corner of the screen area to capture.
The Y coordinate of the upper-left corner of the screen area to capture.
The width of the screen area to capture, in pixels.
The height of the screen area to capture, in pixels.
A handle of type PHT_JOB containing the results of this asynchronous operation or PRL_INVALID_HANDLE if there's not enough memory to instantiate the job object.
For local connections, the capture works almost instantly. For remote connections, the data must be transferred over network to the client machine, so it may take some time.
To get the return code from the PHT_JOB object, use the PrlJob_GetRetCode function. Possible value are:
PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.
PRL_ERR_SUCCESS - function completed successfully.
Copyright © 1999-2010 Parallels Holdings, Ltd. and its affiliates. All rights reserved.