Метод IPersistFolder::Initialize (shobjidl_core.h)

Указывает объекту папки оболочки инициализировать себя на основе переданных сведений.

Синтаксис

HRESULT Initialize(
  PCIDLIST_ABSOLUTE pidl
);

Параметры

pidl

Тип: LPCITEMIDLIST

Адрес структуры ITEMIDLIST (список идентификаторов элементов), указывающий абсолютное расположение папки.

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

Тип: HRESULT

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

Комментарии

Все объекты, реализующие интерфейс IShellFolder для использования в пространстве имен оболочки, должны реализовывать этот метод. Если расположение папки в пространстве имен не является релевантной, этот метод может просто вернуть S_OK. Если расположение относится к папке, следует сохранить полный идентификатор IDLIST, переданный в для последующего использования.

Например, если реализации папки необходимо создать полный указатель на список идентификаторов элементов (PIDL) на содержащиеся в ней элементы, то для создания полных PIDL-списков следует использовать piDL, переданные этому методу.

Требования