ITextDocument::Save-Methode (tom.h)

Artikel
08/26/2023

Speichert das Dokument.

Syntax

HRESULT Save(
  [in] VARIANT *pVar,
  [in] long    Flags,
  [in] long    CodePage
);

Parameter

[in] pVar

Typ: VARIANT*

Das Speicherziel. Bei diesem Parameter handelt es sich um einen VARIANT-Parameter, der ein Dateiname oder NULL sein kann.

[in] Flags

Typ: long

Dateierstellungs-, Open-, Freigabe- und Konvertierungsflags. Eine Liste der möglichen Werte finden Sie unter ITextDocument::Open.

[in] CodePage

Typ: long

Die angegebene Codepage. Gängige Werte sind CP_ACP (null: System-ANSI-Codepage), 1200 (Unicode) und 1208 (UTF-8).

Rückgabewert

Typ: HRESULT

Der Rückgabewert kann ein HRESULT-Wert sein, der einem Systemfehlercode oder einem COM-Fehlercode entspricht, einschließlich eines der folgenden Werte.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode ist erfolgreich.
E_INVALIDARG	Ungültiges Argument.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.
E_NOTIMPL	Feature nicht implementiert.

Hinweise

Um die Parameter zu verwenden, die zum Öffnen der Datei angegeben wurden, verwenden Sie null Werte für die Parameter.

Wenn pVar NULL ist oder fehlt, wird der Dateiname verwendet, der im Namen dieses Dokuments angegeben wird. Wenn beides fehlt oder NULL ist, schlägt die Methode fehl.

Wenn pVar einen Dateinamen angibt, sollte dieser Name die aktuelle Name-Eigenschaft ersetzen. Ebenso können die Argumente Flags und CodePage die in der ITextDocument::Open-Methode bereitgestellten Argumente überschreiben und die Werte definieren, die für Dateien verwendet werden sollen, die mit der ITextDocument::New-Methode erstellt wurden.

Unicode-Nur-Text-Dateien sollten mit der Unicode-Bytereihenfolgemarkierung (0xFEFF) als erstes Zeichen gespeichert werden. Dieses Zeichen sollte entfernt werden, wenn die Datei eingelesen wird. Das heißt, es wird nur für den Import/Export verwendet, um den Nur-Text als Unicode zu identifizieren und die Bytereihenfolge dieses Texts zu identifizieren. Microsoft Editor hat diese Konvention übernommen, die jetzt vom Unicode-Standard empfohlen wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h
DLL	Msftedit.dll