|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
GetFileSize
The GetFileSize function retrieves the size, in bytes, of the specified file.
DWORD GetFileSize(
HANDLE hFile, // handle of file to get size of LPDWORD lpFileSizeHigh // address of high-order word for file size );
Parameters
hFile
Specifies an 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
Points 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
If the function succeeds, the return value is the low-order doubleword of the file size, and, if lpFileSizeHigh is non-NULL, the function puts the high-order doubleword of the file size into the variable pointed to by that parameter. If the function fails and lpFileSizeHigh is NULL, the return value is 0xFFFFFFFF. To get extended error information, call GetLastError. If the function fails and lpFileSizeHigh is non-NULL, the return value is 0xFFFFFFFF and GetLastError will return a value other than NO_ERROR.
Remarks
You cannot use the GetFileSize function with a handle of a nonseeking device such as a pipe or a communications device. To determine the file type for hFile, use the GetFileType function. The GetFileSize function obtains the uncompressed size of a file. Use the GetCompressedFileSize function to obtain the compressed size of a file. Note that if the return value is 0xFFFFFFFF and lpFileSizeHigh is non-NULL, an application must call GetLastError to determine whether the function has succeeded or failed. The following sample code illustrates this point:
// // Case One: calling the function with // lpFileSizeHigh == NULL // Try to obtain hFile's size dwSize = GetFileSize (hFile, NULL) ; // If we failed ... if (dwSize == 0xFFFFFFFF) { // Obtain the error code. dwError = GetLastError() ; // Deal with that failure. . . . } // End of error handler // // Case Two: calling the function with // lpFileSizeHigh != NULL // Try to obtain hFile's huge size.
dwSizeLow = GetFileSize (hFile, & dwSizeHigh) ; // If we failed ... if (dwSizeLow == 0xFFFFFFFF && (dwError = GetLastError()) != NO_ERROR ){ // Deal with that failure. . . . } // End of error handler.
See Also
GetCompressedFileSize, GetFileType
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
GetFileSize
Функция GetFileSize извлекает размер, в байтах, определенного файла.
DWORD GetFileSize(
РУЧКА hFile, // ручка файла, чтобы получать размер адреса LPDWORD lpFileSizeHigh // старшего слова для файлового размера );
Параметры
hFile
Определяет открытую ручку файла, чей размер возвращается. Ручка по-видимому создана с GENERIC_READ или доступом GENERIC_WRITE к файлу.
lpFileSizeHigh
Точки на переменную где старшее слово файлового размера возвращано. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если приложение не требует старшее слово.
Обратные Величины
Если функция добивается успеха, обратная величина - младшее двойное слово файлового размера, и, если lpFileSizeHigh не-НЕДЕЙСТВИТЕЛЕН, функция устанавливает старшее двойное слово файлового размера в переменную указанную, чтобы этим параметром. Если функция терпит неудачу и lpFileSizeHigh НЕДЕЙСТВИТЕЛЕН, обратная величина - 0xFFFFFFFF. Для того, чтобы расширять информацию ошибки, назовите GetLastError. Если функция терпит неудачу и lpFileSizeHigh не-НЕДЕЙСТВИТЕЛЕН, обратная величина - 0xFFFFFFFF и GetLastError возвращает величину кроме NO_ERROR.
Замечания
Вы не можете использовать функцию GetFileSize с ручкой nonseeking устройства как например, труба или устройство связи. Для того, чтобы определять файловый тип для hFile, используйте функцию GetFileType. Функция GetFileSize получает несжатый размер файла. Используйте функцию GetCompressedFileSize, чтобы получать сжатый размер файла. Отметьтесь, что если обратная величина - 0xFFFFFFFF и lpFileSizeHigh не-НЕДЕЙСТВИТЕЛЕН, приложение должно назвать GetLastError, чтобы определять получила функция или терпела неудачу. Следующий код образца иллюстрирует эту точку:
// // Случай Один: вызов функции с // lpFileSizeHigh == НЕДЕЙСТВИТЕЛЬНЫЙ // Попытка, чтобы получать размер hFile's dwSize = GetFileSize (hFile, НЕДЕЙСТВИТЕЛЬНЫЙ); // Если мы потерпели бы неудачу... если (dwSize == 0xFFFFFFFF) { // Получите код ошибки. dwError = GetLastError(); // Сделка с этой неудачей. . . . } // Конец вручителя ошибки // // Случай Два: вызов функции с // lpFileSizeHigh != НЕДЕЙСТВИТЕЛЬНЫЙ // Попытка, чтобы получать огромный размер hFile's.
dwSizeLow = GetFileSize (hFile, & dwSizeHigh); // Если мы потерпели бы неудачу... если (dwSizeLow == 0xFFFFFFFF && (dwError = GetLastError()) != NO_ERROR ){ // Сделка с этой неудачей. . . . } // Конец вручителя ошибки.
Смотри Также
GetCompressedFileSize, GetFileType
|
|
|
|
| |