IShellLibrary：：LoadLibraryFromKnownFolder 方法 (shobjidl_core.h)

项目
03/05/2024

加载 KNOWNFOLDERID 引用的库。

语法

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
标头	shobjidl_core.h (包括 Shobjidl.h)