На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

IShellFolder::GetAttributesOf



[Теперь Поддерживанное на Windows NT]

Извлекает атрибуты одного или более файловых объектов или subfolders.

HRESULT GetAttributesOf(

UINT cidl, // НОМЕР файла возражает LPCITEMIDLIST *apidl, // Указатель в массив указателей в структуры ITEMIDLIST ULONG *ценный Адрес rgfInOut //, содержащий атрибуты файловых объектов
);


Параметры

cidl

Номер файла возражает против получать атрибуты.

apidl

Указатель в массив указателей в структуры ITEMIDLIST, который однозначно идентифицирует файловый объект относительно родительской папки. Каждая структура ITEMIDLIST должна содержать точно один структура SHITEMID сопровождалась завершающим нулем.

rgfInOut

Адресуйте величину ULONG, которая определяет общие атрибуты (logically AND'ed) определенных файловых объектов.



Обратные Величины

Возвращает 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 определенные файловые объекты или папки должны быть отображены используя икону ghosted.
SFGAO_LINK определенные файловые объекты - кратчайшие пути.
SFGAO_READONLY определенные файловые объекты или папки только для чтения.
SFGAO_SHARE определенные папки распространены.


Файловые объектные флаги содержания могут включить нуль или более следующего величин:

Маска SFGAO_CONTENTSMASK для атрибутов содержания.
SFGAO_HASSUBFOLDER определенные папки имеют subfolders (и -, следовательно, расширяемый в левом подокне Исследователя Окна).


Файловый объект может иметь нуль или более следующих смешанных атрибутов:

SFGAO_FILESYSTEM определенные папки или файловые объекты - часть файловой системы (то есть, они - файлы, директории, или корневые директории).
SFGAO_FILESYSANCESTOR определенные папки содержат одна или более файловых системных папок.
SFGAO_FOLDER определенные пункты являются папками.
SFGAO_REMOVABLE определенные файловые объекты или папки находятся на сменном носителе.
SFGAO_VALIDATE Подтверждает кеш информацию.


Замечания

Вы можете оптимизировать эту операцию не возвращать неопределенные флаги.

Смотри Также

IShellFolder, ITEMIDLIST, SHITEMID


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz