На главную

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 | Скачать Вниз

SHGetDataFromIDList



[Now Supported on Windows NT]

The ShGetDataFromIDList function retrieves extended property data from a relative IDList.

HRESULT ShGetDataFromIDList(

LPSHELLFOLDER psf, //Points to the parent folder
LPCITEMIDLIST pidl, //Points to an item identifier struct
int nFormat, //Specifies a format
PVOID pv, //Points to a buffer for a structure
int cb //Size of the buffer passed in
);


Parameters

psf

Pointer to the parent folder.

pidl

Pointer to an ITEMIDLIST structure that identifies the subfolder relative to its parent folder.

nFormat

Specifies one of the following formats:

SHGDFIL_FINDDATA Format used for file system objects.
SHGDFIL_NETRESOURCE Format used for network resources.


pv

Pointer to a buffer for either a WIN32_FIND_DATA or NET_RESOURCE structure, depending on the value of the nFormat parameter. For more information, see the Remarks section below.

cb

Size of the buffer passed in. This value should be either sizeof(WIN32_FIND_DATA) for SHGDFIL_FINDDATA or, sizeof(NETRESOURCE) + 1024 to retrieve a SHGDFIL_NETRESOURCE structure.



Return Values

The return value is NOERROR if the format is supported and the function succeeds. If the psf, pidl, pv, or cb parameters do not match the nFormat parameter, or if nFormat is not one of the specific SHGDFIL_ values shown, E_INVALIDARG is also returned.

Remarks

If nFormat is SHGDFIL_NETRESURCE, there are two possible cases. If the buffer is large enough, the net resource's string information (fields for the network name, local name, provider, and comments) will be placed into the buffer. If the buffer is not large enough, only the net resource structure will be placed into the buffer and the string information pointers will be NULL.


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

SHGetDataFromIDList



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

Функция ShGetDataFromIDList извлекает расширенные данные свойства из относительного IDList.

HRESULT ShGetDataFromIDList(

LPSHELLFOLDER psf, //ТОЧКИ на родительскую папку LPCITEMIDLIST pidl, //Точки на идентификатор пункта struct int nFormat, //Определяет формат PVOID pv, //Точки на буфер для структуры int cb //Размер буфера пройденного в
);


Параметры

psf

Указатель в родительскую папку.

pidl

Указатель в структуру ITEMIDLIST, которая идентифицирует subfolder относительно своей родительской папки.

nFormat

Определяет одно из следующего форматов:

Формат SHGDFIL_FINDDATA использованный для файловой системы возражает.
Формат SHGDFIL_NETRESOURCE использовался для сетевых ресурсов.


pv

Указатель в буфер для или WIN32_FIND_DATA или структура NET_RESOURCE, в зависимости от величины параметра nFormat. Более подробно, смотри секцию Замечаний ниже.

cb

Размер буфера проходил в. Эта величина должна быть или sizeof(WIN32_FIND_DATA) для SHGDFIL_FINDDATA или, sizeof(NETRESOURCE) + 1024, чтобы извлекать структуру SHGDFIL_NETRESOURCE.



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

Обратная величина - NOERROR если формат поддерживан и функция добивается успеха. Если psf, pidl, pv, или cb параметры не соответствуют параметру nFormat, или если nFormat - не одной из специфических величин SHGDFIL_ показанных, E_INVALIDARG также возвращан.

Замечания

Если nFormat - SHGDFIL_NETRESURCE, есть два возможных случая. Если буфер - большой достаточно, информация строки чистого ресурса (области для сетевого имени, локального имени, поставщик, и комментариев), будут установлены в буфер. Если буфер - не большой достаточно, только чистая структура ресурса будет установлена в буфер и информационные указатели строки будут НЕДЕЙСТВИТЕЛЬНЫ.


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