Метод IPersistFolder3::InitializeEx (shobjidl_core.h)

Инициализирует папку и указывает ее расположение в пространстве имен. Если папка является ярлыком, этот метод также указывает расположение целевой папки.

Синтаксис

HRESULT InitializeEx(
  [in] IBindCtx                         *pbc,
  [in] PCIDLIST_ABSOLUTE                pidlRoot,
  [in] const PERSIST_FOLDER_TARGET_INFO *ppfti
);

Параметры

[in] pbc

Тип: IBindCtx*

Указатель на объект IBindCtx , предоставляющий контекст привязки. Этот параметр может принимать значение NULL.

[in] pidlRoot

Тип: LPCITEMIDLIST

Указатель на полный ИДЕНТИФИКАТОР PIDL, указывающий абсолютное расположение папки или ярлыка папки. Вызывающее приложение отвечает за выделение и освобождение этого PIDL-файла.

[in] ppfti

Тип: const PERSIST_FOLDER_TARGET_INFO*

Указатель на структуру PERSIST_FOLDER_TARGET_INFO , указывающую расположение целевой папки и ее атрибуты.

Если ppfti указывает на допустимую структуру, pidlRoot представляет ярлык папки.

Если для ppfti задано значение NULL, pidlRoot представляет обычную папку. В этом случае InitializeEx должен вести себя так, как если бы был вызван метод Initialize .

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Эта функция является расширенной версией IPersistFolder::Initialize. Это позволяет оболочке инициализировать ярлыки папок, а также обычные папки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional с пакетом обновления 3 (SP3), Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
DLL	Shell32.dll (версия 5.0 или более поздняя)