.. highlightlang:: us

.. _shell_createshortcut:

Shell_CreateShortcut
====================

.. index:: Shell_CreateShortcut

.. us.tag  Shell_CreateShortcut NOTREADYGERMAN FILE_MISC New530

:ref:`Shell_CreateShortcut` erstellt eine Verknüpfung zu einem Programm oder einer
Datei auf dem Desktop, im Programmmenü oder an anderen Orten.

.. function::  bool = Shell_CreateShortcut(ssLinkTarget, ssArgs, ssLinkName, ssFolder, ssDescription, ssIconPath, nIconIndex)

.. us.return

**Returnwert**

*bool* ist TRUE (1) wenn der Aufruf erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: ssLinkTarget

   *ssLinkTarget* ist das Ziel, z. B. ``GetRootDirectory() +  "program/uniplot.exe"``.

.. uparam:: ssArgs

   *ssArgs* sind die Start-Argumente. Kann leerer String sein.

.. uparam:: ssLinkName

   *ssLinkName* ist der Name des Links z. B. ``UniPlot 5.2``.

.. uparam:: ssFolder

   *ssFolder* ist das Verzeichnis, siehe :ref:`Shell_GetSpecialFolder`.

.. uparam:: ssDescription

   *ssDescription* ist die Beschreibung der Verknüpfung.

.. uparam:: ssIconPath

   *ssIconPath* ist der vollständige Pfad der exe-Datei oder DLL die Icons enthält,
   z. B. ``GetRootDirectory() +  "program/uniplot.exe"``.

.. uparam:: nIconIndex

   *nIconIndex* ist der Index des Icons (0 für das erste Icon).

.. us.example

**Beispiel**

::

   ssUniPlot = GetRootDirectory() +  "program/uniplot.exe";
   ssFolder = Shell_GetSpecialFolder(2); // Start Menu\Programs
   print Shell_CreateShortcut(ssUniPlot, "", "UniPlot-5.2.1", ..
                              ssFolder, "", ssUniPlot, 0);

.. us.history

**History**

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

   * - Version
     - Beschreibung
   * - 5.3.0
     - Neu.

.. seealso::
   :ref:`uberblick-dateien`,
   :ref:`Shell_GetSpecialFolder`

:sub:`id-361107`