Функция SHLoadLibraryFromParsingName (shobjidl_core.h)

Статья
08/26/2023

Создает и загружает объект IShellLibrary для указанного пути.

Синтаксис

HRESULT SHLoadLibraryFromParsingName(
  [in]  PCWSTR pszParsingName,
  [in]  DWORD  grfMode,
  [in]  REFIID riid,
  [out] void   **ppv
);

Параметры

[in] pszParsingName

Тип: PCWSTR

Путь, по которому нужно загрузить объект IShellLibrary .

[in] grfMode

Тип: DWORD

Один или несколько флагов среды хранения, определяющих режимы доступа и общего доступа для объекта библиотеки. Часто задаваемые флаги STGM_READ илиSTGM_READWRITE. Дополнительные сведения см. в разделе STGM.

[in] riid

Тип: REFIID

Ссылка на IID интерфейса, извлекаемого через ppv, обычно IID_IShellLibrary.

[out] ppv

Тип: void**

При успешном возвращении этого метода содержит указатель интерфейса, запрошенный в riid. Обычно это IShellLibrary.

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

Тип: HRESULT

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

Мы рекомендуем использовать макрос IID_PPV_ARGS , определенный в Objbase.h, для упаковки параметров riid и ppv . Этот макрос предоставляет правильный КОД на основе интерфейса, на который указывает значение в ppv, что исключает возможность ошибки кодирования в riid , которая может привести к непредвиденным результатам.

Это встроенная вспомогающая функция, которая заключает в оболочку метод IShellLibrary::LoadLibraryFromItem .

Требования


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