IPersistFileFormat.Save(String, Int32, UInt32) Methode

Definition

Speichert eine Kopie des Objekts in der angegebenen Datei.

public:
 int Save(System::String ^ pszFilename, int fRemember, System::UInt32 nFormatIndex);
public:
 int Save(Platform::String ^ pszFilename, int fRemember, unsigned int nFormatIndex);
int Save(std::wstring const & pszFilename, int fRemember, unsigned int nFormatIndex);
public int Save (string pszFilename, int fRemember, uint nFormatIndex);
abstract member Save : string * int * uint32 -> int
Public Function Save (pszFilename As String, fRemember As Integer, nFormatIndex As UInteger) As Integer

Parameter

pszFilename
String

[in] Zeiger auf den Dateinamen. Der- pszFilename Parameter kann sein null . er weist das-Objekt an, mithilfe der aktuellen Datei zu speichern. Wenn sich das Objekt im unbenannten Zustand befindet und als an das-Objekt über null mittelt wird pszFilename , gibt das-Objekt zurück E_INVALIDARG . Sie müssen in dieser Situation einen gültigen Dateinamenparameter angeben.

fRemember
Int32

in Boolescher Wert, der angibt, ob der pszFileName Parameter als aktuelle Arbeitsdatei verwendet werden soll. Wenn true , pszFileName wird die aktuelle Datei, und das-Objekt sollte das Änderungsflag nach dem Speichern löschen. falseGibt an, dass dieser Speichervorgang eine Kopie als Vorgang speichern als Vorgang ist. In diesem Fall bleibt die aktuelle Datei unverändert und das Objekt löscht nicht ihr Dirty-Flag. Wenn pszFileName ist null , ignoriert die-Implementierung das- fRemember Flag.

nFormatIndex
UInt32

[in] Wert, der das Format angibt, in dem die Datei gespeichert wird. Der Aufrufer übergibt DEF_FORMAT_INDEX, wenn das Objekt sein standardmäßiges (aktuelles) Format auswählen muss. Wenn dies auf auf ungleich 0 (null) festgelegt wird, wird der Wert als der Index in die Liste der Formate interpretiert, wie durch einen Aufruf der Methode GetFormatList(String) zurückgegeben. Ein Indexwert von 0 gibt das erste Format 1, das zweite Format, usw. an.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

Aus fpstfmt. idl:

HRESULT IPersistFileFormat::Save(  
   [in] LPCOLESTR pszFilename,  
   [in] BOOL fRemember,  
   [in] DWORD nFormatIndex  
);  

Gilt für