 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function retrieves the size, in bytes, of the specified file. CeGetFileSizeis a remote application interface (RAPI), which enables an application running on a desktop computer to make function calls on a Windows CE–based device.
DWORD CeGetFileSize( HANDLE hFile , LPDWORD lpFileSizeHigh );
Parameters
- hFile
- [in] Open handle of the file whose size is being returned. The handle must have been created with either GENERIC_READ or GENERIC_WRITE access to the file.
- lpFileSizeHigh
- [out] Pointer to the variable where the high-order word of the
file size is returned. This parameter can be NULL if the
application does not require the high-order word.
Return Values
The low-order DWORDof the file size indicates success. If lpFileSizeHighis non-NULL, the function puts the high-order DWORDof the file size into the variable pointed to by that parameter. If lpFileSizeHighis NULL, 0xFFFFFFFF indicates failure. To get extended error information, call CeGetLastError.
If lpFileSizeHighis non-NULL, 0xFFFFFFFF indicates failure and CeGetLastErrorreturns a value other than NO_ERROR.
Remarks
When working with RAPI for Windows CE versions 1.0 and 1.01, use the PegGetFileSizefunction.
For more information about using RAPI functions, see Invoking Functions from a Desktop Computer.
Requirements
Runs On Versions Defined in Include Link to Windows CE OS 2.0 and later Rapi.h See Also