IShellLibrary::SaveInKnownFolder 方法 (shobjidl_core.h)

將連結庫儲存至指定之已知資料夾中的新檔案。

語法

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

參數

[in] kfidToSaveIn

類型: REFKNOWNFOLDERID

要在其中儲存 IShellLibrary 物件的已知資料夾識別碼。

如需詳細資訊,請參閱 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 媒體櫃