Windows API Guide - Reference - Volume 1: Version 3.0 For the MS-DOS and PC-DOS Operating Systems

Type SHFILEINFO hIcon As Long iIcon As Long dwAttributes As Long szDisplayName As String * 260 szTypeName As String * 80 End Type

Description & Usage

The SHFILEINFO structure holds information about a file system object pertaining to the system shell. The structure can hold such information as a handle to its icon and its display name in the shell. Depending on the flags used in the SHGetFileInfo function, not all of the structure's data members may necessarily hold useful information.

Visual Basic-Specific Issues

None.

Data Members

hIcon

A handle to the icon used to represent the file system object in the shell. Your program must destroy this icon via DestroyIcon after using it to save resources.

iIcon

The index of the file system's icon within the system image list.

dwAttributes

A combination of the following flags specifying the attributes of the file system object:

FILE_ATTRIBUTE_ARCHIVE

An archive file (which most files are).

FILE_ATTRIBUTE_COMPRESSED

A file residing in a compressed drive or directory.

FILE_ATTRIBUTE_DIRECTORY

A directory instead of a file.

FILE_ATTRIBUTE_HIDDEN

A hidden file, not normally visible to the user.

FILE_ATTRIBUTE_NORMAL

An attribute-less file (cannot be combined with other attributes).

FILE_ATTRIBUTE_READONLY

A read-only file.

FILE_ATTRIBUTE_SYSTEM

A system file, used exclusively by the operating system.

szDisplayName

A null-terminated string specifying the name of the file system object as it appears in the system shell. For files, this will be the full path and filename.

szTypeName

A null-terminated string specifying the name of the type of the file system object.

Constant Definitions

Const FILE_ATTRIBUTE_ARCHIVE = &H20 Const FILE_ATTRIBUTE_COMPRESSED = &H800 Const FILE_ATTRIBUTE_DIRECTORY = &H10 Const FILE_ATTRIBUTE_HIDDEN = &H2 Const FILE_ATTRIBUTE_NORMAL = &H0 Const FILE_ATTRIBUTE_READONLY = &H1 Const FILE_ATTRIBUTE_SYSTEM = &H4

Used By

SHGetFileInfo

Go back to the alphabetical Structure listing. Go back to the Reference section index.

Last Modified: December 22, 1999 This page is copyright © 1999 Paul Kuliniewicz. Copyright Information Revised October 29, 2000 Go back to the Windows API Guide home page. E-mail: vbapi@vbapi.com Send Encrypted E-Mail This page is at http://www.vbapi.com/ref/s/shfileinfo.html