IShellFolder::GetAttributesOf

【勇芳软件工作室】汉化HomePreviousNext

[Now Supported on Windows NT]

检索一个或多个文件对象或子文件夹的属性。

HRESULT GetAttributesOf(

UINT 【CIDL】,//文件对象数
LPCITEMIDLIST *【apidl】,//指向ITEMIDLIST结构的指针数组的指针
ULONG *【rgfInOut】//包含文件对象属性的值的地址
); 

参数

【CIDL】

要获取属性的文件对象数。

【apidl】

指向ITEMIDLIST结构的指针数组的指针,每个结构唯一地标识相对于父文件夹的文件对象。每个ITEMIDLIST结构必须包含一个SHITEMID结构,后跟一个终止零。

【rgfInOut】

指定指定文件对象的通用(逻辑与)属性的ULONG值的地址。

返回值

如果成功返回NOERROR,否则返回OLE定义的错误值。

备注

下表列出了此方法可能返回的属性标志。文件对象属性包括能力标志,显示属性,内容标志和其他属性。

文件对象的能力标志可以包括以下零个或多个值:

SFGAO_CANCOPY可以复制指定的文件对象或文件夹(与DROPEFFECT_COPY标志相同的值)。
SFGAO_CANDELETE可以删除指定的文件对象或文件夹。
SFGAO_CANLINK可以为指定的文件对象或文件夹创建快捷方式(与DROPEFFECT_LINK标志相同的值)。
SFGAO_CANMOVE可以移动指定的文件对象或文件夹(与DROPEFFECT_MOVE标志相同的值)。
SFGAO_CANRENAME可以重命名指定的文件对象或文件夹。
SFGAO_CAPABILITYMASK掩码为能力标志。
SFGAO_DROPTARGET指定的文件对象或文件夹是放置目标。
SFGAO_HASPROPSHEET指定的文件对象或文件夹具有属性表。

文件对象的显示属性可能包含以下值中的零个或多个:

SFGAO_DISPLAYATTRMASK面具显示属性。
SFGAO_GHOSTED指定的文件对象或文件夹应使用幻影图标显示。
SFGAO_LINK指定的文件对象是快捷方式。
SFGAO_READONLY指定的文件对象或文件夹是只读的。
SFGAO_SHARE指定的文件夹是共享的。

文件对象的内容标志可能包含以下值中的零个或多个:

SFGAO_CONTENTSMASK面具的内容属性。
SFGAO_HASSUBFOLDER指定的文件夹具有子文件夹(因此可以在Windows资源管理器的左窗格中展开)。

文件对象可能具有以下其他属性的零个或多个:

SFGAO_FILESYSTEM指定的文件夹或文件对象是文件系统的一部分(即它们是文件,目录或根目录)。
SFGAO_FILESYSANCESTOR指定的文件夹包含一个或多个文件系统文件夹。
SFGAO_FOLDER指定的项目是文件夹。
SFGAO_REMOVABLE指定的文件对象或文件夹位于可移动媒体上。
SFGAO_VALIDATE验证缓存信息。

备注

您可以通过不返回未指定的标志来优化此操作。

也可以看看

IShellFolder, ITEMIDLIST, SHITEMID