Freigeben über


IRootStorage::SwitchToFile-Methode (objidl.h)

Die SwitchToFile-Methode kopiert die aktuelle Datei, die dem Speicherobjekt zugeordnet ist, in eine neue Datei. Die neue Datei wird dann für das Speicherobjekt und alle Änderungen ohne Commit verwendet.

Syntax

HRESULT SwitchToFile(
  LPOLESTR pszFile
);

Parameter

pszFile

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Dateinamen für die neue Datei angibt. Es darf nicht der Name einer vorhandenen Datei sein. Wenn NULL, erstellt diese Methode eine temporäre Datei mit einem eindeutigen Namen, und Sie können IStorage::Stat aufrufen, um den Namen der temporären Datei abzurufen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK Die Datei wurde erfolgreich kopiert.
STG_E_MEDIUMFULL Die Datei wurde aufgrund unzureichenden Speicherplatzes auf dem Speichergerät nicht kopiert.
STG_E_ACCESSDENIED Die Datei wurde nicht kopiert, da der Aufrufer nicht über die Berechtigung für den Zugriff auf das Speichergerät verfügt.
STG_E_INVALIDPOINTER Die Datei wurde nicht kopiert, da der pszFile-Zeiger ungültig ist.
STG_E_FILEALREADYEXISTS Die Datei wurde nicht kopiert, da der neue Dateiname (pszFile) auf eine vorhandene Datei verweist.

Hinweise

Die IRootStorage::SwitchToFile-Methode kopiert die Datei, die dem Speicherobjekt zugeordnet ist. Ein COM-Container ruft SwitchToFile auf, um eine Datei in einer Situation mit wenig Arbeitsspeicher vollständig zu speichern. In der Regel erfolgt dies erst, nachdem ein normaler, vollständiger Speichervorgang (d. h. in einer temporären Datei speichern, Ursprüngliche Datei löschen, temporäre Datei umbenennen) mit einem E_OUTOFMEMORY Fehler fehlgeschlagen ist.

Es ist falsch, die SwitchToFile-Methode aufzurufen, wenn das Speicherobjekt oder etwas, das darin enthalten ist, in einen anderen Prozess gemarshallt wurde. Vor dem Aufrufen von SwitchToFile muss der Container die IPersistStorage::HandsOffStorage-Methode für jedes Element innerhalb des geladenen oder ausgeführten Speicherobjekts aufrufen. Die HandsOffStorage-Methode erzwingt, dass das Element seine Speicherzeiger freigibt und in den speicherbasierten Modus wechselt. Der Container muss auch alle Zeiger auf Streams oder Speicher freigeben, die in diesem Stammspeicher enthalten sind. Nachdem der vollständige Speichervorgang abgeschlossen ist, gibt der Container die enthaltenen Elemente in den normalen Speichermodus zurück.

Hinweise für Implementierer

Wenn Sie Eigene Speicherobjekte implementieren, dürfen die IRootStorage-Methoden (einschließlich QueryInterface, AddRef und Release) keinen zusätzlichen Arbeitsspeicher oder Dateihandles verbrauchen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile objidl.h
Bibliothek Uuid.lib
DLL Ole32.dll

Weitere Informationen

IPersistStorage::HandsOffStorage

IPersistStorage::SaveCompleted

IStorage::Commit

IStorage::Stat