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

  • Статья

Инициализирует обработчик с помощью IShellItem.

Синтаксис

HRESULT Initialize(
  [in] IShellItem *psi,
  [in] DWORD      grfMode
);

Параметры

[in] psi

Тип: IShellItem*

Указатель на IShellItem.

[in] grfMode

Тип: DWORD

Одно из следующих значений STGM , указывающих режим доступа для psi.

STGM_READ

Элемент IShellItem доступен только для чтения.

STGM_READWRITE

IShellItem доступен для чтения и записи.

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

Тип: HRESULT

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

Комментарии

Если доступ к элементу IShellItem невозможен, этот метод возвращает соответствующий код ошибки.

Экземпляр обработчика следует инициализировать только один раз в течение его времени существования. Попытки вызывающего приложения повторно инициализировать обработчик приводят к ошибке HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Propsys.h)