Метод IShellLibrary::LoadLibraryFromKnownFolder (shobjidl_core.h)
Загружает библиотеку, на которую ссылается ИЗВЕСТНЫЙFOLDERID.
Синтаксис
HRESULT LoadLibraryFromKnownFolder(
[in] REFKNOWNFOLDERID kfidLibrary,
[in] DWORD grfMode
);
Параметры
[in] kfidLibrary
Тип: REFKNOWNFOLDERID
Значение KNOWNFOLDERID , определяющее загружаемую библиотеку.
[in] grfMode
Тип: DWORD
Один или несколько средних флагов хранилища STGM , которые указывают режимы доступа и общего доступа для объекта библиотеки.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Если объект IShellLibrary содержит библиотеку при вызове этого метода, эта библиотека перезаписывается в памяти с помощью новой библиотеки.
Если для этой библиотеки нет объекта IShellLibrary , вместо этого метода можно вызвать SHLoadLibraryFromItem .
Примеры
В следующем примере кода показана вспомогающая функция SHLoadLibraryFromKnownFolder, которая заключает этот метод в оболочку.
//
// from shobjidl.h
//
__inline HRESULT SHLoadLibraryFromKnownFolder(
__in REFKNOWNFOLDERID kfidLibrary,
__in DWORD grfMode,
__in REFIID riid,
__deref_out void **ppv)
{
*ppv = NULL;
IShellLibrary *plib;
HRESULT hr = CoCreateInstance(
CLSID_ShellLibrary,
NULL,
CLSCTX_INPROC_SERVER,
IID_PPV_ARGS(&plib));
if (SUCCEEDED(hr))
{
hr = plib->LoadLibraryFromKnownFolder(kfidLibrary, grfMode);
if (SUCCEEDED(hr))
{
hr = plib->QueryInterface(riid, ppv);
}
plib->Release();
}
return hr;}
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | shobjidl_core.h (включая Shobjidl.h) |