.. highlightlang:: us

.. index:: DocSave

.. _docsave:

DocSave
=======

.. us.tag  DocSave GERMAN DocSet Changed412 Changed5400

:ref:`DocSave` speichert ein Dokument.

.. function::  bool = DocSave(hDoc, ssFileName)
               bool = DocSave(hDoc, ssFileName, nFlags)

.. us.return

**Returnwert**

*bool* ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: hDoc

   *hDoc* ist die Zugriffsnummer des mit :ref:`DocCreate` erzeugten Dokuments.

.. uparam:: ssFileName

   *ssFileName* ist der vollständige Dateiname. Der Name muß die Erweiterung
   :file:`.ipw` oder :file:`.ipz` haben.

.. uparam:: nFlags

   .. list-table::
      :header-rows: 1

      * - Flags
        - Bedeutung
      * - ``DOC_SAVE_MRU`` (1)
        - Der Dateiname in die Liste der zuletzt geöffneten Dateien eingetragen.

.. us.example

**Beispiel**

::

  // Use the forward slash:
  DocSave(hDoc, "d:/myfiles/doc.ipz")

  // or double backslashes:
  DocSave(hDoc, "d:\\myfiles\\doc.ipz")

.. us.comment

**Kommentar**

Falls eine Datei mit dem gleichen Namen schon existiert, wird die Datei ohne
Rückfrage überschrieben. Falls eine Datei mit dem gleichen Namen schon existiert
und die Datei geöffnet ist, schlägt die Funktion fehl.

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2012 (5.40.0)
     - Speichern im verbesserten IPZ-Dateiformat.

.. seealso::
   :ref:`uberblick-dokumente`,
   :ref:`DocCreate`,
   :ref:`DocSaveModified`,
   :ref:`DocSetPathName`

:sub:`id-1226046`