|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| kernel32.lib
| Header File
| winbase.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
GetVolumeInformation
The GetVolumeInformation function returns information about a file system and volume whose root
directory is specified.
BOOL GetVolumeInformation(
LPCTSTR lpRootPathName,
| // address of root directory of the file system
| LPTSTR lpVolumeNameBuffer,
| // address of name of the volume
| DWORD nVolumeNameSize,
| // length of lpVolumeNameBuffer
| LPDWORD lpVolumeSerialNumber,
| // address of volume serial number
| LPDWORD lpMaximumComponentLength,
| // address of system's maximum filename length
| LPDWORD lpFileSystemFlags,
| // address of file system flags
| LPTSTR lpFileSystemNameBuffer,
| // address of name of file system
| DWORD nFileSystemNameSize
| // length of lpFileSystemNameBuffer
| );
|
|
Parameters
lpRootPathName
Points to a string that contains the root directory of the volume to be
described. If this parameter is NULL, the root of the current directory is used. If
this parameter is a UNC name, you must follow it with an additional backslash.
For example, you would specify \\MyServer\MyShare as \\MyServer\MyShare\.
lpVolumeNameBuffer
Points to a buffer that receives the name of the specified volume.
nVolumeNameSize
Specifies the length, in characters, of the volume name buffer. This parameter
is ignored if the volume name buffer is not supplied.
lpVolumeSerialNumber
Points to a variable that receives the volume serial number. This parameter
can be NULL if the serial number is not required.
lpMaximumComponentLength
Points to a doubleword value that receives the maximum length, in characters,
of a filename component supported by the specified file system. A filename
component is that portion of a filename between backslashes.
The value stored in variable pointed to by *lpMaximumComponentLength is used to indicate that long names are supported by the specified file
system. For example, for a FAT file system supporting long names, the function
stores the value 255, rather than the previous 8.3 indicator. Long names can also be
supported on systems that use the New Technology file system.
lpFileSystemFlags
Points to a doubleword that receives flags associated with the specified file
system. This parameter can be any combination of the following flags, with one
exception: FS_FILE_COMPRESSION and FS_VOL_IS_COMPRESSED are mutually exclusive.
Value
| Meaning
| FS_CASE_IS_PRESERVED
| If this flag is set, the file system preserves the case of filenames when it
places a name on disk.
| FS_CASE_SENSITIVE
| If this flag is set, the file system supports case-sensitive filenames.
| FS_UNICODE_STORED_ON_DISK
| If this flag is set, the file system supports Unicode in filenames as they
appear on disk.
| FS_PERSISTENT_ACLS
| If this flag is set, the file system preserves and enforces ACLs. For example,
NTFS preserves and enforces ACLs, and FAT does not.
| FS_FILE_COMPRESSION
| The file system supports file-based compression.
| FS_VOL_IS_COMPRESSED
| The specified volume is a compressed volume; for example, a DoubleSpace volume.
|
lpFileSystemNameBuffer
Points to a buffer that receives the name of the file system (such as FAT or
NTFS).
nFileSystemNameSize
Specifies the length, in characters, of the file system name buffer. This
parameter is ignored if the file system name buffer is not supplied.
Return Values
If all the requested information is retrieved, the return value is nonzero.
If not all the requested information is retrieved, the return value is zero.
To get extended error information, call GetLastError.
Remarks
If you are attempting to obtain information about a floppy drive that does not
have a floppy disk or a CD-ROM drive that does not have a compact disc, the
system displays a message box asking the user to insert a floppy disk or a
compact disc, respectively. To prevent the system from displaying this message box,
call the SetErrorMode function with SEM_FAILCRITICALERRORS.
The FS_VOL_IS_COMPRESSED flag is the only indicator of volume-based
compression. The file system name is not altered to indicate compression. This flag comes
back set on a DoubleSpace volume, for example. With volume-based compression,
an entire volume is either compressed or not compressed.
The FS_FILE_COMPRESSION flag indicates whether a file system supports
file-based compression. With file-based compression, individual files can be compressed
or not compressed.
The FS_FILE_COMPRESSION and FS_VOL_IS_COMPRESSED flags are mutually exclusive;
both bits cannot come back set.
The maximum component length value, stored in the DWORD variable pointed to by lpMaximumComponentLength, is the only indicator that a volume supports longer-than-normal FAT (or
other file system) file names. The file system name is not altered to indicate
support for long file names.
The GetCompressedFileSize function obtains the compressed size of a file. The GetFileAttributes function can determine whether an individual file is compressed.
See Also
GetCompressedFileSize, GetFileAttributes, SetErrorMode, SetVolumeLabel
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
