please dont rip this site Prev Next

SHGetFileInfo info

Retrieves information about an object in the file system, such as a file, a folder, a directory, or a drive root.

WINSHELLAPI DWORD WINAPI SHGetFileInfo(

    LPCTSTR pszPath,

    DWORD dwFileAttributes,

    SHFILEINFO FAR *psfi,

    UINT cbFileInfo,

    UINT uFlags

   );

Parameters

pszPath
Pointer to a buffer that contains the path and filename. Both absolute and relative paths are valid. If uFlags includes the SHGFI_PIDL, value pszPath must be the address of an ITEMIDLIST structure that contains the list of item identifiers that uniquely identifies the file within the shell’s name space.

This string can use either short (the 8.3 form) or long filenames.

dwFileAttributes
Array of file attribute flags (FILE_ATTRIBUTE_ values). If uFlags does not include the SHGFI_USEFILEATTRIBUTES value, this parameter is ignored.
psfi and cbFileInfo
Address and size, in bytes, of the SHFILEINFO structure that receives the file information.
uFlags
Flag that specifies the file information to retrieve. This parameter can be a combination of the following values:

SHGFI_ATTRIBUTES

Retrieves the file attribute flags. The flags are copied to the dwAttributes member of the structure specified by psfi.

SHGFI_DISPLAYNAME

Retrieves the display name for the file. The name is copied to the szDisplayName member of the structure specified by psfi.

The returned display name uses the long filename, if any, rather than the 8.3 form of the filename.

SHGFI_EXETYPE

Returns the type of the executable file if pszPath identifies an executable file. For more information, see the comments below.

SHGFI_ICON

Retrieves the handle of the icon that represents the file and the index of the icon within the system image list. The handle is copied to the hIcon member of the structure specified by psfi, and the index is copied to the iIcon member. The return value is the handle of the system image list.

SHGFI_ICONLOCATION

Retrieves the name of the file that contains the icon representing the file. The name is copied to the szDisplayName member of the structure specified by psfi.

SHGFI_LARGEICON

Modifies SHGFI_ICON, causing the function to retrieve the file’s large icon.

SHGFI_LINKOVERLAY

Modifies SHGFI_ICON, causing the function to add the link overlay to the file’s icon.

SHGFI_OPENICON

Modifies SHGFI_ICON, causing the function to retrieve the file’s open icon. A container object displays an open icon to indicate that the container is open.

SHGFI_PIDL

Indicates that pszPath is the address of an ITEMIDLIST structure rather than a path name.

SHGFI_SELECTED

Modifies SHGFI_ICON, causing the function to blend the file’s icon with the system highlight color.

SHGFI_SHELLICONSIZE

Modifies SHGFI_ICON, causing the function to retrieve a shell-sized icon. If this flag is not specified, the function sizes the icon according to the system metric values.

SHGFI_SMALLICON

Modifies SHGFI_ICON, causing the function to retrieve the file’s small icon.

SHGFI_SYSICONINDEX

Retrieves the index of the icon within the system image list. The index is copied to the iIcon member of the structure specified by psfi. The return value is the handle of the system image list.

SHGFI_TYPENAME

Retrieves the string that describes the file’s type. The string is copied to the szTypeName member of the structure specified by psfi.

SHGFI_USEFILEATTRIBUTES

Indicates that the function should use the dwFileAttributes parameter.

To retrieve the executable file type, uFlags must specify only SHGFI_EXETYPE. The return value specifies the type of the executable file:

0

Nonexecutable file or an error condition.

LOWORD = NE or PE
HIWORD = 3.0, 3.5, or 4.0

Windows application

LOWORD = MZ
HIWORD = 0

MS-DOS .EXE, .COM or .BAT file

LOWORD = PE
HIWORD = 0

Win32 console application

Return Values

See:


file: /Techref/os/win/api/win32/func/src/f85_2.htm, 9KB, , updated: 2001/3/7 13:59, local time: 2024/11/10 00:11,
TOP NEW HELP FIND: 
3.141.19.165:LOG IN
©2024 PLEASE DON'T RIP! THIS SITE CLOSES OCT 28, 2024 SO LONG AND THANKS FOR ALL THE FISH!

 ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!

<A HREF="http://linistepper.com/techref/os/win/api/win32/func/src/f85_2.htm"> SHGetFileInfo</A>

After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.


Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?