DMM Studio-Onlinehilfe › DMM Studio › Sprachstruktur › EXISTS-Befehle

EXISTS-Befehle

CA DMM-Skripten verwenden die folgenden EXISTS-Befehle:

DirectoryExists

Überprüft, ob ein bestimmtes Verzeichnis existiert. Dieser Befehl umfasst zwei Parameter. Bei dem ersten Parameter handelt es sich um den Verzeichnispfad als Zeichenfolge. Der zweite Parameter gibt an, ob auf dem Quell- oder dem Zielrechner gesucht werden soll. Der zweite Parameter ist ein boolescher Wert, bei dem es sich um eine optionale Angabe handelt. Wenn der zweite Parameter aktiviert ist, sucht der Interpreter auf dem Quellrechner nach der angegebenen Datei. Wenn der Parameter deaktiviert ist oder ausgelassen wird, sucht der Interpreter auf dem Zielrechner.

Hinweis: Der boolesche Parameter kann nur bei der allgemeinen Funktion sowie bei den GENERAL- und APPLY-Funktionen verwendet werden. Wenn der Wert für andere Zwecke verwendet wird, treten Syntax- oder Laufzeitfehler auf.

Erster Parameter:

Der Verzeichnispfad (Zeichenfolge)

Zweiter Parameter:

Der Rechnerindikator (Boolescher Wert)

Verwendung:

DirectoryExists( <Directory path>, [Boolean] );

Beispiel:

if (DirectoryExists( "c:\\My Documents"))
 StoreDirectory( "c:\\My Documents");

if (DirectoryExists( "c:\\My Documents", SOURCE))
 ApplyDirectory( "c:\\My Documents");

FileExists

Überprüft, ob eine Datei auf dem Quell- oder auf dem Zielrechner vorhanden ist. Der erste Parameter ist eine Zeichenfolge und stellt den Dateipfad dar. Der zweite Parameter gibt an, ob auf dem Quell- oder auf dem Zielrechner gesucht werden soll. Der zweite Parameter ist ein boolescher Wert, bei dem es sich um eine optionale Angabe handelt. Wenn der zweite Parameter aktiviert ist, sucht der Interpreter auf dem Quellrechner nach der angegebenen Datei. Wenn der Parameter deaktiviert ist oder ausgelassen wird, sucht der Interpreter auf dem Zielrechner.

Hinweis: Der boolesche Parameter kann nur bei der allgemeinen Funktion sowie bei den GENERAL- und APPLY-Funktionen verwendet werden. Wenn der Wert für andere Zwecke verwendet wird, treten Syntax- oder Laufzeitfehler auf.

Erster Parameter:

Der Dateipfad (Zeichenfolge)

Zweiter Parameter:

Der Rechnerindikator (Boolescher Wert)

Verwendung:

FileExists( <file path> );

Beispiele:

if (FileExists( "c:\\My Documents\\myfile.txt"))
    StoreFile( "c:\\My Documents\\myfile.txt");

if (FileExists( "c:\\My Documents\\myfile.txt", SOURCE))

KeyExists

Überprüft, ob auf dem Quell- oder Zielrechner ein Registrierungsschlüssel vorhanden ist. Es können zwei Parameter verwendet werden. Der erste Parameter ist eine Zeichenfolge und gibt den Pfad für den Registrierungsschlüssel an. Der zweite Parameter gibt an, ob auf dem Quell- oder dem Zielrechner gesucht werden soll. Der zweite Parameter ist ein boolescher Wert, bei dem es sich um eine optionale Angabe handelt. Wenn der zweite Parameter aktiviert ist, sucht der Interpreter auf dem Quellrechner nach dem angegebenen Schlüssel. Wenn der Parameter deaktiviert ist oder ausgelassen wird, sucht der Interpreter auf dem Zielrechner.

Hinweis: Der boolesche Parameter kann nur bei der allgemeinen Funktion sowie bei den GENERAL- und APPLY-Funktionen verwendet werden. Wenn der boolesche Wert für andere Zwecke verwendet wird, treten Syntax- oder Laufzeitfehler auf.

Erster Parameter:

Der Pfad des Schlüssels (Zeichenfolge)

Zweiter Parameter:

Der Rechnerindikator (Boolescher Wert)

Verwendung:

KeyExists( <key path> );

Beispiel:

if (KeyExists( "HKLM\\Software\\Microsoft\\Plus!", SOURCE))
    ApplyKey( "HKLM\\Software\\Microsoft\\Plus!");

ValueExists

Überprüft, ob in der Registrierung oder INI-Datei ein Wert eines Registrierungsschlüssels vorhanden ist. Für diesen Befehl können zwei bzw. drei Parameter verwendet werden. Beim ersten Parameter handelt es sich um dem Pfad des Registrierungsschlüssels, beim zweiten Parameter handelt es sich um den Namen des Werts. Die ersten beiden Parameter sind Zeichenfolgen und müssen angegeben werden. Der dritte Parameter gibt an, ob auf dem Quell- oder dem Zielrechner gesucht werden soll. Der dritte Parameter ist ein boolescher Wert, bei dem es sich um eine optionale Angabe handelt. Wenn der dritte Parameter aktiviert ist, sucht der Interpreter auf dem Quellrechner nach dem angegebenen Schlüssel. Wenn der Parameter deaktiviert ist oder ausgelassen wird, sucht der Interpreter auf dem Zielrechner.

Hinweis: Der dritte boolesche Parameter kann nur bei der allgemeinen Funktion sowie bei den GENERAL- und APPLY-Funktionen verwendet werden. Wenn der dritte boolesche Parameter für andere Zwecke verwendet wird, treten Syntax- oder Laufzeitfehler auf.

Erster Parameter:

Der Pfad des Schlüssels (Zeichenfolge)

Zweiter Parameter:

Der Name des Werts (Zeichenfolge)

Dritter Parameter:

Der Rechner (Boolescher Wert)

Verwendung:

ValueExists( <Key path>, <Value name>, [Boolean] );

Beispiel:

if (ValueExists( "HKCU\\Control Panel\\Desktop", "Smooth Scrolling", SOURCE))
   ApplyValue( "HKCU\\Control Panel\\Desktop", "Smooth Scrolling");