IShellLibrary::SaveInKnownFolder-Methode (shobjidl_core.h)

  • Artikel

Speichert die Bibliothek in einer neuen Datei in einem angegebenen bekannten Ordner.

Syntax

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

Parameter

[in] kfidToSaveIn

Typ: REFKNOWNFOLDERID

Die ID des bekannten Ordners, in dem das IShellLibrary-Objekt gespeichert werden soll.

Weitere Informationen finden Sie unter KNOWNFOLDERID.

[in] pszLibraryName

Typ: LPCWSTR

Der Dateiname, unter dem die Bibliothek gespeichert werden soll. Der Dateiname darf nicht die Dateinamenerweiterung enthalten. Die Dateinamenerweiterung wird automatisch hinzugefügt.

[in] lsf

Typ: LIBRARYSAVEFLAGS

Der LIBRARYSAVEFLAGS-Wert , der angibt, wie eine Bibliotheksnamenkollision behandelt wird.

[out] ppsiSavedTo

Typ: IShellItem**

Das IShellItem-Objekt , das die Bibliotheksbeschreibungsdatei darstellt, in der die Bibliothek gespeichert wurde.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

IShellLibrary::Save und SHSaveLibraryInFolderPath erstellen eine neue Bibliotheksdatei und speichern die Datei auf dem Datenträger.

Rufen Sie IShellLibrary::Commit auf, um Änderungen an einer Bibliothek zu speichern, die über eine vorhandene Bibliotheksdatei verfügt.

Wenn die Bibliothek im bekannten Ordner Bibliotheken (FOLDERID_Libraries) gespeichert wird, wird der Speicherort der Bibliothek automatisch dem Systemindex hinzugefügt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

IShellLibrary

Bekannte Ordner (Beispiel)

Bibliotheksbeschreibungsschema

SHSaveLibraryInFolderPath

Windows-Bibliotheken