The HTTPSERVERTRANSFER structure provides information about the
last file transfer performed by a client.
typedef struct _HTTPSERVERTRANSFER
{
DWORD dwSize;
DWORD dwReserved;
DWORD dwFileAccess;
DWORD dwTimeElapsed;
ULARGE_INTEGER uiBytesCopied;
TCHAR szFileName[MAX_PATH];
} HTTPSERVERTRANSFER, *LPHTTPSERVERTRANSFER;
Members
- dwSize
- An unsigned integer value that specifies the size of the
structure.
- dwReserved
- An unsigned integer value that is reserved for future use. This
value will always be zero.
- dwFileAccess
- An unsigned integer value that specifies the how the local file
was accessed. It can be one of the following values:
| Constant |
Description |
HTTP_FILE_READ
(0) |
The file was opened for reading. This mode indicates that
the client issued the GET command to download the contents of a
file from the server to the client system. The szFileName
member specifies the name of the local file on the server that
was downloaded by the client. |
HTTP_FILE_WRITE
(1) |
The file was opened for writing. This mode indicates that
the client issued the PUT command to upload the
contents of a file from the client system to server. The
szFileName member specifies the name of the local file on
the server that was created by the client. If a file already
existed with the name name, it was replaced. |
- dwTimeElapsed
- The amount of time that it took for the file transfer to
complete in milliseconds. This value is limited to the resolution of
the system timer, which is typically in the range of 10 to 16
milliseconds. This value may be zero if the transfer occurred over a
local network or on the same host using a loopback address.
- uiBytesCopied
- A 64-bit integer value that specifies the total number of bytes
copied during the file transfer. This value is represented by a
ULARGE_INTEGER union which provides support for those programming
languages that do not have intrinsic support for 64-bit integers.
For more information, refer to the Windows SDK documentation. The
application should not make the assumption that this is the actual
size of the file.
- szFileName
- A pointer to a string value that will contain the full path
to the local file that was transferred. The dwFileAccess member
determines whether the file name represents a file that was
downloaded by the client, or uploaded from the client and stored on
the server.
Remarks
When an instance of this structure is passed to the
GetTransferInfo
method, the dwSize member must be initialized to the size of the
structure, otherwise the method will fail with an error indicating that
the parameter is invalid. All other members should be initialized to a
value of zero.
Requirements
Minimum Desktop Platform: Windows 7 (Service Pack 1)
Minimum Server Platform: Windows Server 2008 R2 (Service Pack 1)
Header File: cstools10.h
Unicode: Implemented as Unicode and ANSI versions.
See Also
GetTransferInfo
|