[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 | 验证缓存信息。 |
备注
您可以通过不返回未指定的标志来优化此操作。
也可以看看