|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
GetDiskFreeSpaceEx
[New - Windows NT]
[New - Windows 95, OEM Service Release 2]
The GetDiskFreeSpaceEx function obtains information about the amount of space available on a disk volume: the total amount of space, the total amount of free space, and the total amount of free space available to the user associated with the calling thread. Windows 95 OSR 2:
The GetDiskFreeSpaceEx function is available on Windows 95 systems beginning with OEM Service Release 2 (OSR 2). Use the GetVersionEx function to determine that a system is running OSR 2 or a later release of the Windows 95 operating system. The GetVersionEx function fills in the members of an OSVERSIONINFO data structure. If the dwPlatformId member of that structure is VER_PLATFORM_WIN32_WINDOWS, and the low word of the dwBuildNumber member is greater than 1000, the system is running OSR 2 or a later release.
Once you have determined that a system is running OSR 2, call the LoadLibrary or LoadLibraryEx function to load the KERNEL32.DLL file, then call the GetProcAddress function to obtain an address for the GetDiskFreeSpaceEx function. Use that address to call the function.
BOOL GetDiskFreeSpaceEx(
LPCTSTR lpDirectoryName, // pointer to directory name on disk of interest PULARGE_INTEGER lpFreeBytesAvailableToCaller, // pointer to variable to receive free bytes on disk available to the caller PULARGE_INTEGER lpTotalNumberOfBytes, // pointer to variable to receive number of bytes on disk PULARGE_INTEGER lpTotalNumberOfFreeBytes // pointer to variable to receive free bytes on disk );
Parameters
lpDirectoryName
Pointer to a null-terminated string that specifies a directory on the disk of interest. This string can be a UNC name.
If lpDirectoryName is NULL, the GetDiskFreeSpaceEx function obtains information about the disk that contains the currect directory. Note that lpDirectoryName does not have to specify the root directory on a disk. The function accepts any directory on the disk.
lpFreeBytesAvailableToCaller
Pointer to a variable to receive the total number of free bytes on the disk that are available to the user associated with the calling thread.
If the operating system implements per-user quotas, this value may be less than the total number of free bytes on the disk.
lpTotalNumberOfBytes
Pointer to a variable to receive the total number of bytes on the disk.
lpTotalNumberOfFreeBytes
Pointer to a variable to receive the total number of free bytes on the disk. This parameter can be NULL.
Return Values
If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call GetLastError.
Remarks
Note that the values obtained by this function are of type ULARGE_INTEGER. Be careful not to truncate these values to 32 bits. The GetDiskFreeSpaceEx function lets you avoid the arithmetic required by the GetDiskFreeSpace function.
See Also
GetDiskFreeSpace
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
GetDiskFreeSpaceEx
[Новый - Windows NT]
[Новый - Окно 95, Выпуск Услуги OEM 2]
Функция GetDiskFreeSpaceEx получает информацию о сумме космической доступной в дисковом объеме: общая сумма пространства, общая сумма свободного пространства, и общая сумма свободная космическая пригодная для пользователя связывались вызовом резьбы. Windows 95 OSR 2:
Функция GetDiskFreeSpaceEx доступна в системах Windows 95, начинаемых с Версии Услуги OEM 2 (OSR 2). Используйте функцию GetVersionEx, чтобы определять, что система выполняет OSR 2 или последующую версию операционной системы Windows 95. Функция GetVersionEx заполняет участников структуры данных OSVERSIONINFO. Если элемент dwPlatformId этой структуры - VER_PLATFORM_WIN32_WINDOWS, и низкое слово элемента dwBuildNumber больше, чем 1000, система выполняет OSR 2 или последующую версию.
Как только Вы определили, что система выполняет OSR 2, назовите LoadLibrary или функцию LoadLibraryEx, чтобы загружать файл KERNEL32.DLL затем называть функцию GetProcAddress, чтобы получать адрес для функции GetDiskFreeSpaceEx. Использование, что обращаться, чтобы называть функцию.
BOOL GetDiskFreeSpaceEx(
LPCTSTR lpDirectoryName, // УКАЗАТЕЛЬ в имя директория на диске интереса PULARGE_INTEGER lpFreeBytesAvailableToCaller, // указателя в переменную, чтобы получать свободные байты на дисковом пригодном для вызывающего оператора PULARGE_INTEGER lpTotalNumberOfBytes, // указателя в переменную, чтобы получать количество байтов на указателе диска PULARGE_INTEGER lpTotalNumberOfFreeBytes // в переменную, чтобы получать свободные байты на диске );
Параметры
lpDirectoryName
Указатель в недействительный расторгнутую строку, которая определяет директорий на диске интереса. Эта строка может быть именем UNC.
Если lpDirectoryName НЕДЕЙСТВИТЕЛЕН, функция GetDiskFreeSpaceEx получает информацию о диске, который содержит директорий currect. Отметьте, что lpDirectoryName нет должен определить корневой директорий на диске. Функция принимает любой директорий на диске.
lpFreeBytesAvailableToCaller
Указатель в переменную, чтобы получать общее число свободных байтов на диске, который пригодный для пользователя связанного вызовом резьбы.
Если операционная система осуществляется за-квоты пользователя, эта величина может быть менее чем общее число свободных байтов на диске.
lpTotalNumberOfBytes
Указатель в переменную, чтобы получать общее число байтов на диске.
lpTotalNumberOfFreeBytes
Указатель в переменную, чтобы получать общее число свободных байтов на диске. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН.
Обратные Величины
Если функция добивается успеха, обратная величина ненулевая. Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.
Замечания
Отметьте, что величины полученные этой функцией - типа ULARGE_INTEGER. Быть осторожным не, чтобы исключать эти величины на 32 битов. Функция GetDiskFreeSpaceEx позволяет, чтобы Вы избегаете арифметики требовавшейся функцией GetDiskFreeSpace.
Смотри Также
GetDiskFreeSpace
|
|
|
|
| |