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


Метод 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)

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

IShellLibrary

IShellLibrary::LoadLibraryFromItem

SHCreateLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromKnownFolder

SHLoadLibraryFromParsingName

Библиотеки Windows