IShellLibrary::SaveInKnownFolder 方法 (shobjidl_core.h)

将库保存到指定已知文件夹中的新文件。

语法

HRESULT SaveInKnownFolder(
  [in]  REFKNOWNFOLDERID kfidToSaveIn,
  [in]  LPCWSTR          pszLibraryName,
  [in]  LIBRARYSAVEFLAGS lsf,
  [out] IShellItem       **ppsiSavedTo
);

参数

[in] kfidToSaveIn

类型: REFKNOWNFOLDERID

要在其中保存 IShellLibrary 对象的已知文件夹的 ID。

有关详细信息,请参阅 KNOWNFOLDERID

[in] pszLibraryName

类型: LPCWSTR

用于保存库的文件名。 文件名不得包含文件扩展名;将自动添加文件扩展名。

[in] lsf

类型: LIBRARYSAVEFLAGS

指定如何处理库名称冲突的 LIBRARYSAVEFLAGS 值。

[out] ppsiSavedTo

类型: IShellItem**

IShellItem 对象,表示保存库的库说明文件。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

IShellLibrary::SaveSHSaveLibraryInFolderPath 创建新的库文件,并将该文件保存到磁盘。

若要保存对具有现有库文件的库所做的更改,请调用 IShellLibrary::Commit

如果库保存在库已知文件夹中 (FOLDERID_Libraries) ,则库的位置会自动添加到系统索引中。

要求

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

另请参阅

IShellLibrary

已知文件夹示例

库说明架构

SHSaveLibraryInFolderPath

Windows 库