Поделиться через


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

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

Синтаксис

HRESULT SHLoadLibraryFromKnownFolder(
  [in]  REFKNOWNFOLDERID kfidLibrary,
  [in]  DWORD            grfMode,
  [in]  REFIID           riid,
  [out] void             **ppv
);

Параметры

[in] kfidLibrary

Тип: REFKNOWNFOLDERID

Значение KNOWNFOLDERID , определяющее известную папку для загрузки в объект IShellLibrary .

[in] grfMode

Тип: DWORD

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

[in] riid

Тип: REFIID

Идентификатор IID для IShellLibrary. (Дополнительные сведения см. в разделе Примечания.)

[out] ppv

Тип: void**

При успешном возврате этой функции получает загруженный объект IShellLibrary . (Дополнительные сведения см. в разделе Примечания.)

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

Тип: HRESULT

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

Комментарии

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

Использования

Макрос IID_PPV_ARGS обычно используется для создания параметров riid и ppv для этой функции. Пример см. в разделе SHCreateLibrary.

Требования

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

См. также раздел

IShellLibrary

IShellLibrary::LoadLibraryFromItem

IShellLibrary::LoadLibraryFromKnownFolder

Пример: известные папки

SHCreateLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromParsingName