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