SHLoadLibraryFromKnownFolder 函数 (shobjidl_core.h)
为指定的已知文件夹 ID 创建并加载 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
IShellLibrary 的 IID。 (有关详细信息,请参阅备注。)
[out] ppv
类型: void**
当此函数成功返回时,接收加载的 IShellLibrary 对象。 (有关详细信息,请参阅备注。)
返回值
类型: HRESULT
如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
这是一个内联帮助程序函数,用于包装 IShellLibrary::LoadLibraryFromKnownFolder 方法。
用法
IID_PPV_ARGS 宏通常用于生成此函数的 riid 和 ppv 参数。 有关示例,请参阅 SHCreateLibrary。要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |
另请参阅
IShellLibrary::LoadLibraryFromItem