Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

IShellFolder::GetAttributesOf

[Now Supported on Windows NT]

Retrieves the attributes of one or more file objects or subfolders.

HRESULT GetAttributesOf(

UINT cidl,
// Number of file objects
LPCITEMIDLIST *apidl,
// Pointer to array of pointers to ITEMIDLIST structures
ULONG *rgfInOut
// Address of value containing attributes of the file objects
);

Parameters

cidl

Number of file objects to get the attributes of.

apidl

Pointer to an array of pointers to ITEMIDLIST structures, each of which uniquely identifies a file object relative to the parent folder. Each ITEMIDLIST structure must contain exactly one SHITEMID structure followed by a terminating zero.

rgfInOut

Address of a ULONG value that specifies the common (logically AND'ed) attributes of specified file objects.

Return Values

Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks

The following tables list the attribute flags that may be returned by this method. File object attributes include capability flags, display attributes, contents flags, and miscellaneous attributes.

A file object's capability flags may include zero or more of the following values:

SFGAO_CANCOPY
The specified file objects or folders can be copied (same value as the DROPEFFECT_COPY flag).
SFGAO_CANDELETE
The specified file objects or folders can be deleted.
SFGAO_CANLINK
It is possible to create shortcuts for the specified file objects or folders (same value as the DROPEFFECT_LINK flag).
SFGAO_CANMOVE
The specified file objects or folders can be moved (same value as the DROPEFFECT_MOVE flag).
SFGAO_CANRENAME
The specified file objects or folders can be renamed.
SFGAO_CAPABILITYMASK
Mask for the capability flags.
SFGAO_DROPTARGET
The specified file objects or folders are drop targets.
SFGAO_HASPROPSHEET
The specified file objects or folders have property sheets.

A file object's display attributes may include zero or more of the following values:

SFGAO_DISPLAYATTRMASK
Mask for the display attributes.
SFGAO_GHOSTED
The specified file objects or folders should be displayed using a ghosted icon.
SFGAO_LINK
The specified file objects are shortcuts.
SFGAO_READONLY
The specified file objects or folders are read-only.
SFGAO_SHARE
The specified folders are shared.

A file object's contents flags may include zero or more of the following values:

SFGAO_CONTENTSMASK
Mask for the contents attributes.
SFGAO_HASSUBFOLDER
The specified folders have subfolders (and are, therefore, expandable in the left pane of Windows Explorer).

A file object may have zero or more of the following miscellaneous attributes:

SFGAO_FILESYSTEM
The specified folders or file objects are part of the file system (that is, they are files, directories, or root directories).
SFGAO_FILESYSANCESTOR
The specified folders contain one or more file system folders.
SFGAO_FOLDER
The specified items are folders.
SFGAO_REMOVABLE
The specified file objects or folders are on removable media.
SFGAO_VALIDATE
Validate cached information.

Remarks

You can optimize this operation by not returning unspecified flags.

See Also

IShellFolder
, ITEMIDLIST, SHITEMID

Software for developers
Delphi Components
.Net Components
Software for Android Developers
More information resources
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
Databases for Amazon shops developers
Amazon Categories Database
Browse Nodes Database