На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz