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_READSTGM_READWRITE。 有关详细信息,请参阅 STGM

[in] riid

类型: REFIID

IShellLibrary 的 IID。 (有关详细信息,请参阅备注。)

[out] ppv

类型: void**

当此函数成功返回时,接收加载的 IShellLibrary 对象。 (有关详细信息,请参阅备注。)

返回值

类型: HRESULT

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

这是一个内联帮助程序函数,用于包装 IShellLibrary::LoadLibraryFromKnownFolder 方法。

用法

IID_PPV_ARGS 宏通常用于生成此函数的 riidppv 参数。 有关示例,请参阅 SHCreateLibrary

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

IShellLibrary

IShellLibrary::LoadLibraryFromItem

IShellLibrary::LoadLibraryFromKnownFolder

已知文件夹示例

SHCreateLibrary

SHLoadLibraryFromItem

SHLoadLibraryFromParsingName