Метод IInitializeWithFile::Initialize (propsys.h)

Статья
08/25/2023

Инициализирует обработчик путем к файлу.

Синтаксис

HRESULT Initialize(
  [in] LPCWSTR pszFilePath,
  [in] DWORD   grfMode
);

Параметры

[in] pszFilePath

Тип: LPCWSTR

Указатель на буфер, содержащий путь к файлу в виде строки Юникода, завершаемой null.

[in] grfMode

Тип: DWORD

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

STGM_READ

Файл, указанный параметром IInitializeWithFile::Initialize , доступен только для чтения.

STGM_READWRITE

Файл, указанный параметром IInitializeWithFile::Initialize , можно считывать и записывать в.

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

Тип: HRESULT

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

Инициализация предпочтительна этому методу из-за его возможности использовать файлы, недоступные по пути Win32, например содержимое сжатого файла с расширением имени файла .zip. Используйте IInitializeWithFile::Initialize , только если API, используемый обработчиком для доступа к файлу, принимает только пути к файлам.

Файл, на который указывает pszFilePath, должен оставаться открытым в течение всего времени существования обработчика или до вызова IPropertyStore::Commit .

Если файл не может быть открыт в соответствии со значениями параметров метода, этот метод возвращает подходящий код ошибки.

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

Требования

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