В этой статьеи будет рассмотрены некоторые Win API функции:
1) GetLogicalDrives
Функция GetLogicalDrives возвращает число-битовую маску в которой храняться все
доступные диски.
DWORD GetLogicalDrives(VOID);
Параметры:
Эта функция не имеет параметров.
Возвращаемое значение:
Если функция вызвана правильно, то она возвращает число-битовую маску в которой
храняться все доступные диски ( если 0 бит равен 1, то диск "A:" присутствует, и т.д. )
Если функция вызвана не правильно, то она возвращает 0.
Пример:
int n;
char dd[4];
DWORD dr = GetLogicalDrives();
for( int i = 0; i < 26; i++ )
{
n = ((dr>>i)&0x00000001);
if( n == 1 )
{
dd[0] = char(65+i); dd[1] = ':'; dd[2] = ''; dd[3] = 0;
cout << "Available disk drives : " << dd << endl;
}
}
2) GetDriveType
Функция GetDriveType возвращает тип диска (removable, fixed, CD-ROM,
RAM disk, или network drive).
UINT GetDriveType(LPCTSTR lpRootPathName);
Параметры:
lpRootPathName
[in] Указатель на не нулевую стоку в которой хранится имя
главной директории на диске. Обратный слэш должен присутствовать!
Если lpRootPathName равно NULL, то функция использует текущую директорию.
Возвращаемое значение:
Функция возвращает тип диска. Могут быть следующие значения:
Значение Описание
DRIVE_UNKNOWN Не известный тип.
DRIVE_NO_ROOT_DIR Не правильный путь.
DRIVE_REMOVABLE Съёмный диск.
DRIVE_FIXED Фиксированный диск.
DRIVE_REMOTE Удалённый или network диск.
DRIVE_CDROM CD-ROM диск.
DRIVE_RAMDISK RAM диск.
Пример:
int d;
d = GetDriveType( "c:" );
if( d == DRIVE_UNKNOWN ) cout << " UNKNOWN" << endl;
if( d == DRIVE_NO_ROOT_DIR ) cout << " DRIVE NO ROOT DIR" << endl;
if( d == DRIVE_REMOVABLE ) cout << " REMOVABLE" << endl;
if( d == DRIVE_FIXED ) cout << " FIXED" << endl;
if( d == DRIVE_REMOTE ) cout << " REMOTE" << endl;
if( d == DRIVE_CDROM ) cout << " CDROM" << endl;
if( d == DRIVE_RAMDISK ) cout << " RAMDISK" << endl;
3) GetVolumeInformation
Функция GetVolumeInformation возвращает информацию о файловой системе и
дисках( директориях ).
BOOL GetVolumeInformation(
LPCTSTR lpRootPathName, // имя диска(директории) [in]
LPTSTR lpVolumeNameBuffer, // название диска [out]
DWORD nVolumeNameSize, // длина буфера названия диска [in]
LPDWORD lpVolumeSerialNumber, // сериальный номер диска [out]
LPDWORD lpMaximumComponentLength, // максимальная длина фыйла [out]
LPDWORD lpFileSystemFlags, // опции файловой системы [out]
LPTSTR lpFileSystemNameBuffer, // имя файловой системы [out]
DWORD nFileSystemNameSize // длина буфера имени файл. сист. [in]
);
Возвращаемое значение:
Если функция вызвана правильно, то она возвращает не нулевое значение(TRUE).
Если функция вызвана не правильно, то она возвращает 0(FALSE).
Пример:
char VolumeNameBuffer[100];
char FileSystemNameBuffer[100];
unsigned long VolumeSerialNumber;
BOOL GetVolumeInformationFlag = GetVolumeInformationA(
"c:",
VolumeNameBuffer,
100,
&VolumeSerialNumber,
NULL, //&MaximumComponentLength,
NULL, //&FileSystemFlags,
FileSystemNameBuffer,
100
);
if(GetVolumeInformationFlag != 0)
{
cout << " Volume Name is " << VolumeNameBuffer << endl;
cout << " Volume Serial Number is " << VolumeSerialNumber << endl;
cout << " File System is " << FileSystemNameBuffer << endl;
}
else cout << " Not Present (GetVolumeInformation)" << endl;
4) GetDiskFreeSpaceEx
Функция GetDiskFreeSpaceEx выдаёт информацию о доступном месте на диске.
BOOL GetDiskFreeSpaceEx(
LPCTSTR lpDirectoryName, // имя диска(директории) [in]
PULARGE_INTEGER lpFreeBytesAvailable, // доступно для использования(байт) [out]
PULARGE_INTEGER lpTotalNumberOfBytes, // максимальный объём( в байтах ) [out]
PULARGE_INTEGER lpTotalNumberOfFreeBytes // свободно на диске( в байтах ) [out]
);
Возвращаемое значение:
Если функция вызвана правильно, то она возвращает не нулевое значение(TRUE).
Если функция вызвана не правильно, то она возвращает 0(FALSE).
Пример:
DWORD FreeBytesAvailable;
DWORD TotalNumberOfBytes;
DWORD TotalNumberOfFreeBytes;
BOOL GetDiskFreeSpaceFlag = GetDiskFreeSpaceEx(
"c:", // directory name
(PULARGE_INTEGER)&FreeBytesAvailable, // bytes available to caller
(PULARGE_INTEGER)&TotalNumberOfBytes, // bytes on disk
(PULARGE_INTEGER)&TotalNumberOfFreeBytes // free bytes on disk
);
if(GetDiskFreeSpaceFlag != 0)
{
cout << " Total Number Of Free Bytes = " << (unsigned long)TotalNumberOfFreeBytes
<< "( " << double(unsigned long(TotalNumberOfFreeBytes))/1024/1000
<< " Mb )" << endl;
cout << " Total Number Of Bytes = " << (unsigned long)TotalNumberOfBytes
<< "( " << double(unsigned long(TotalNumberOfBytes))/1024/1000
<< " Mb )" << endl;
}
else cout << " Not Present (GetDiskFreeSpace)" << endl;
5) GlobalMemoryStatus
Функция GlobalMemoryStatus возвращает информацию о используемой системой памяти.
VOID GlobalMemoryStatus(
LPMEMORYSTATUS lpBuffer // указатель на структуру MEMORYSTATUS
);
typedef struct _MEMORYSTATUS {
DWORD dwLength; // длина структуры в байтах
DWORD dwMemoryLoad; // загрузка памяти в процентах
SIZE_T dwTotalPhys; // максимальное количество физической памяти в байтах
SIZE_T dwAvailPhys; // свободное количество физической памяти в байтах
SIZE_T dwTotalPageFile; // макс. кол. памяти для программ в байтах
SIZE_T dwAvailPageFile; // свободное кол. памяти для программ в байтах
SIZE_T dwTotalVirtual; // максимальное количество виртуальной памяти в байтах
SIZE_T dwAvailVirtual; // свободное количество виртуальной памяти в байтах
} MEMORYSTATUS, *LPMEMORYSTATUS;
Возвращаемое значение:
Эта функция не возвращает параметров
Пример:
// The MemoryStatus structure is 32 bytes long.
// It should be 32.
// 78 percent of memory is in use.
// There are 65076 total Kbytes of physical memory.
// There are 13756 free Kbytes of physical memory.
// There are 150960 total Kbytes of paging file.
// There are 87816 free Kbytes of paging file.
// There are 1fff80 total Kbytes of virtual memory.
// There are 1fe770 free Kbytes of virtual memory.
#define DIV 1024
#define WIDTH 7
char *divisor = "K";
MEMORYSTATUS stat;
GlobalMemoryStatus (&stat);
printf ("The MemoryStatus structure is %ld bytes long.n",
stat.dwLength);
printf ("It should be %d.n", sizeof (stat));
printf ("%ld percent of memory is in use.n",
stat.dwMemoryLoad);
printf ("There are %*ld total %sbytes of physical memory.n",
WIDTH, stat.dwTotalPhys/DIV, divisor);
printf ("There are %*ld free %sbytes of physical memory.n",
WIDTH, stat.dwAvailPhys/DIV, divisor);
printf ("There are %*ld total %sbytes of paging file.n",
WIDTH, stat.dwTotalPageFile/DIV, divisor);
printf ("There are %*ld free %sbytes of paging file.n",
WIDTH, stat.dwAvailPageFile/DIV, divisor);
printf ("There are %*lx total %sbytes of virtual memory.n",
WIDTH, stat.dwTotalVirtual/DIV, divisor);
printf ("There are %*lx free %sbytes of virtual memory.n",
WIDTH, stat.dwAvailVirtual/DIV, divisor);
6) GetComputerName, GetUserNameA
Функция GetComputerName возвращает NetBIOS имя локального компьютера.
BOOL GetComputerName(
LPTSTR lpBuffer, // имя локального компьютера( длина буфера равна MAX_COMPUTERNAME_LENGTH + 1 ) [out]
LPDWORD lpnSize // размер буфера ( лучше поставить MAX_COMPUTERNAME_LENGTH + 1 ) [out/in]
);
Функция GetUserName возвращает имя текущего узера.
BOOL GetUserName(
LPTSTR lpBuffer, // имя юзера( длина буфера равна UNLEN + 1 ) [out]
LPDWORD nSize // размер буфера ( лучше поставить UNLEN + 1 ) [out/in]
);
Возвращаемые значения:
Если функции вызваны правильно, то они возвращают не нулевое значение(TRUE).
Если функции вызваны не правильно, то они возвращают 0(FALSE).
Пример:
char ComputerName[MAX_COMPUTERNAME_LENGTH + 1];
unsigned long len_ComputerName = MAX_COMPUTERNAME_LENGTH + 1;
char UserName[UNLEN + 1];
unsigned long len_UserName = UNLEN + 1;
BOOL comp = GetComputerName(
ComputerName,
&len_ComputerName
);
if( comp != 0 ) { cout << "Computer Name is " << ComputerName << endl; }
else cout << "Computer Name is NOT FOUND !!! " << endl;
comp = GetUserNameA (
UserName,
&len_UserName
);
if( comp != 0 ) { cout << "User Name is " << UserName << endl; }
else cout << "User Name is NOT FOUND !!! " << endl;
7) GetSystemDirectory, GetTempPath, GetWindowsDirectory, GetCurrentDirectory
Функция GetSystemDirectory возвращает путь к системной директории.
UINT GetSystemDirectory(
LPTSTR lpBuffer, // буфер для системной директории [out]
UINT uSize // размер буфера [in]
);
Возвращаемое значение:
Эта функция возвращает размер буфера для системной директории не включая нулевого
значения в конце, если она вызвана правильно.
Если функция вызвана не правильно, то она возвращает 0.
Функция GetTempPath возвращает путь к директории, отведённой для временных файлов.
DWORD GetTempPath(
DWORD nBufferLength, // размер буфера [in]
LPTSTR lpBuffer // буфер для временной директории [out]
);
Возвращаемое значение:
Эта функция возвращает размер буфера для системной директории не включая нулевого
значения в конце, если она вызвана правильно.
Если функция вызвана не правильно, то она возвращает 0.
Функция GetWindowsDirectory возвращает путь к Windows директории.
UINT GetWindowsDirectory(
LPTSTR lpBuffer, // буфер для Windows директории [out]
UINT uSize // размер буфера [in]
);
Возвращаемое значение:
Эта функция возвращает размер буфера для системной директории не включая нулевого
значения в конце, если она вызвана правильно.
Если функция вызвана не правильно, то она возвращает 0.
Функция GetCurrentDirectory возвращает путь к текущей директории.
DWORD GetCurrentDirectory(
DWORD nBufferLength, // размер буфера [in]
LPTSTR lpBuffer // буфер для текущей директории [out]
);
Возвращаемое значение:
Эта функция возвращает размер буфера для системной директории не включая нулевого
значения в конце, если она вызвана правильно.
Если функция вызвана не правильно, то она возвращает 0.
Пример:
char path[100];
GetSystemDirectory( path, 100 );
cout << "System Directory is " << path << endl;
GetTempPath( 100, path );
cout << "Temp path is " << path << endl;
GetWindowsDirectory( path, 100 );
cout << "Windows directory is " << path << endl;
GetCurrentDirectory( 100, path );
cout << "Current directory is " << path << endl;
Для подготовки данной работы были использованы материалы с сайта http://www.realcoding.net/