Функция CIDLData_CreateFromIDArray (shlobj_core.h)
[CIDLData_CreateFromIDArray доступно для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]
Создает объект данных с указателем vtable по умолчанию.
Синтаксис
SHSTDAPI CIDLData_CreateFromIDArray(
[in] PCIDLIST_ABSOLUTE pidlFolder,
[in] UINT cidl,
[in] PCUIDLIST_RELATIVE_ARRAY apidl,
[out] IDataObject **ppdtobj
);
Параметры
[in] pidlFolder
Тип: PCIDLIST_ABSOLUTE
Полный идентификатор IDLIST для корня элементов, указанных в apidl.
[in] cidl
Тип: UINT
Количество записей в массиве apidl .
[in] apidl
Тип: PCUIDLIST_RELATIVE_ARRAY
Массив идентификаторов элементов относительно pidlFolder. Как правило, apidl — это массив идентификаторов дочерних элементов, а pidlFolder — полный PIDL для этих элементов. Однако pidlFolder может иметь значение NULL PIDL (IDLIST рабочего стола). В этом случае apidl может содержать полные списки идентификаторов.
[out] ppdtobj
Тип: IDataObject**
Адрес указателя на объект, реализующий IDataObject.
Возвращаемое значение
Тип: HRESULT
Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Объект данных, созданный этой функцией, предлагает идентификатор формата буфера обмена оболочки CFSTR_SHELLIDLIST. Этот объект данных также поддерживает вызовы IDataObject::SetData для получения других форматов буфера обмена.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | shlobj_core.h (включая Shlobj.h) |
| Библиотека | Shell32.lib |
| DLL | Shell32.dll (версия 5.0 или более поздняя) |
| Набор API | ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240) |