SHLoadLibraryFromKnownFolder 函数 (shobjidl_core.h)

项目
03/02/2024

为指定的已知文件夹 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)