.. highlightlang:: us

.. index:: GetProfileInt

.. _getprofileint:

GetProfileInt
=============

.. us.tag  GetProfileInt GERMAN Changed330 uniplot-registry

:ref:`GetProfileInt` liefert einen ganzzahligen Wert aus einer
Initialisierungsdatei oder der Windows-Registrierdatenbank.

.. function::  rsVal = GetProfileInt(ssSection, ssKey)
    rsVal = GetProfileInt(ssSection, ssKey, ssFileName)
    rsVal = GetProfileInt(ssSection, ssKey, ssFileName, rsDefault)

.. us.return

**Returnwert**

*rsVal* ist der Wert des Schlüssels. Wird kein Defaultwert angegeben und kann
der Schlüssel nicht gefunden werden, liefert die Funktion den Wert 0 zurück.

.. us.params

**Parameter**

.. uparam:: ssSection

   *ssSection* ist der Abschnittsname.

.. uparam:: ssKey

   *ssKey* ist der Schlüssel.

.. uparam:: ssFileName

   *ssFileName* ist der Name der Initialisierungsdatei. Wenn dieser Parameter
   nicht angegeben wird, bzw. wenn ein leerer String (``""``) angegeben wird, 
   liest die Funktion aus der Windows-Registrierdatenbank
   (:file:`HKEY_CURRENT_USER\\Software\\RSB\\UniPlot5`).

.. uparam:: rsDefault

   *rsDefault* ist ein Default-Wert. Kann der Schlüssel in der 
   Initialisierungsdatei oder der Windows-Registrierdatenbank nicht gefunden
   werden, gibt die Funktion den Default-Wert *rsDefault* zurück.

.. us.example

**Beispiel**

Wenn die Datei :file:`d:/test.ini` folgenden Inhalt hat

::

   [Section]
   Key=123

liefert der folgende Aufruf die Zahl 123

::

   val = GetProfileInt("Section", "Key", "d:/test.ini");

.. seealso::
   :ref:`uberblick-dateien`,
   :ref:`WriteProfileString`,
   :ref:`WriteProfileInt`

:sub:`id-872017`