This structure is used by the GetTransferStatus
method to return information about a data transfer in progress.
This structure is designed for use with extended functions that
support files larger than 4GB.
typedef struct _HTTPTRANSFERSTATUSEX
{
ULARGE_INTEGER uiBytesTotal;
ULARGE_INTEGER uiBytesCopied;
DWORD dwBytesPerSecond;
DWORD dwTimeElapsed;
DWORD dwTimeEstimated;
} HTTPTRANSFERSTATUSEX, *LPHTTPTRANSFERSTATUSEX;
Members
- uiBytesTotal
- The total number of bytes that will be transferred. If the data
is being downloaded from the server to the local host, this is
the size of the requested resource. If the data is being uploaded from the
local host to the server, it is the size of the local file or
memory buffer. If the size of the resource cannot be determined, this value
will be zero.
- uiBytesCopied
- The total number of bytes that have been copied.
- dwBytesPerSecond
- The average number of bytes that have been copied per
second.
- dwTimeElapsed
- The number of seconds that have elapsed since the file transfer
started.
- dwTimeEstimated
- The estimated number of seconds until the data transfer is
completed. This is based on the average number of bytes transferred
per second.
Remarks
If the option HTTP_OPTION_HIRES_TIMER has been specified when connecting
to the server, the values returned in the dwTimeElapsed and
dwTimeEstimated members will be in milliseconds instead of
seconds. You can use this option to obtain more accurate elapsed times
when uploading or downloading small amounts of data over a fast network
connection.
Requirements
Minimum Desktop Platform: Windows 7 (Service Pack 1)
Minimum Server Platform: Windows Server 2008 R2 (Service Pack 1)
Header File: cstools10.h
See Also
EnableEvents,
GetTransferStatus,
RegisterEvent,
HTTPTRANSFERSTATUS
|