GetCurrentDirectory

DWORD GetCurrentDirectory( DWORD nBufferLength, LPTSTR lpBuffer);

Возвращаемое значение

Если функция завершается успешно, возвращается количество символов, записанное в буфер, исключая завершающий строку нулевой символ. В противном случае возвращается нулевое значение. Расширенную информацию по ошибке можно получить, вызвав функцию GetLastError.

Если текстовый буфер, на который указывает аргумент lpBuffer, имеет недостаточный размер, возвращаемое значение определяет требуемый размер буфера, включая байты, необходимые для размещения завершающего строку нулевого символа.

Аргументы

0. nBufferLength — определяет размер буфера для хранения строки, содержащей текущий директорий, выраженный в символах. Размер буфера должен учитывать необходимость записи в него завершающего строку нулевого символа.

1. lpBuffer — указатель на буфер для хранения строки, содержащей текущий директорий. В данный буфер будет записана тестовая строка, завершающаяся нулевым символом, и содержащая абсолютный путь к текущему директорию.

Примечание

Функция GetCurrentDirectory позволяет получить путь к текущему директорию данного процесса.

Описание данной функции содержится в файле заголовка winbase.h. При работе с данной функцией следует включить в проект библиотеку kernel32.lib.

GetDiskFreeSpace

BOOL GetDiskFreeSpace( LPCTSTR lpRootPathName, LPDWORD lpSectorsPerCluster, LPDWORD lpBytesPerSector, LPDWORD lpNumberOfFreeClusters, LPDWORD lpTotalNumberOfClusters );

Возвращаемое значение

В случае успешного завершения работы функции возвращает ненулевое значение. В противном случае возвращает нулевое значение. Расширенную информацию по ошибке можно получить, вызвав функцию GetLastError.

Аргументы

0. lpRootPathName — указатель на заканчивающуюся нулём строку, определяющую корневой директорий диска по которому следует получить информацию. Если данный аргумент имеет нулевое значение, функция использует текущий директорий. Если в данном аргументе указан путь на сетевом диске, то после этого имени следует поставить дополнительную косую черту. Так, вместо \\MyServer\MyShare следует указать \\MyServer\MyShare\.

1. В Windows 95 нельзя указывать пути на сетевых дисках в аргументе lpRootPathName. Для получения требуемой информации следует определить этот директорий как диск, получить информацию по этому диску и снять определение. Возможность использования путей на сетевых дисках появилась только в Windows 95 OSR2 и более поздних версиях.

2. lpSectorsPerCluster — указатель на переменную, в которую будет записано число секторов в кластере.

3. lpBytesPerSector — указатель на переменную, в которую будет записано число байт в секторе.

4. lpNumberOfFreeClusters — указатель на переменную, в которую будет записано общее число свободных кластеров на диске, которое может быть выделено текущему потоку.

5. lpTotalNumberOfClusters — указатель на переменную, в которую будет записано общее число кластеров на диске, которое может быть использовано текущим потоком.

Примечание

Размер областей, возвращаемых функцией GetDiskFreeSpace, не может превышать 2 ГБ. Значения, записываемые в аргументы данной функции, могут не совпадать с физическим разбиением диска, однако их произведения дают верную информацию об объёмах менее 2 ГБ.

В Windows 95 OSR2 и более поздних версиях определена функция GetDiskFreeSpaceEx, использующая 64-разрядные переменные и возвращающая корректную информацию о дисках размером более 2 ГБ.

Описание данной функции содержится в файле заголовка winbase.h. При работе с данной функцией следует включить в проект библиотеку kernel32.lib.