1.2.21 BatchAdd – Zeile in Batch hinzufügen
BatchAdd(strKey,strValue,strPositKey,nOption);
|
Argumente
|
strKey:
Gibt das zur Batch-Datei hinzuzufügende Schlüsselwort an. PATH, TEMP und MYENV sind Beispiele für gültige Schlüssel.
strValue:
Gibt den Wert des Schlüsselwortes, das der Batch-Datei hinzugefügt wird. Diese Zeichenkette darf nicht länger sein als 512 Bytes. Wird eine Zeichenkette übergeben, die länger ist als 512 Bytes, so erfolgt ein Setup-Fehler.
Batch-Dateien unterstützen lange Pfadnamen nicht uneingeschränkt.
Will man mit dieser Funktion eine Zeile hinzufügen, die einen langen Pfadnamen enthält, ruft man LongPathToShortPath auf, um den langen Pfad zum entsprechenden kurzen zu konvertieren, bevor man ihn dem String hinzufügt, der in der Batch-Datei plaziert wird.
|
|
|
StrPositKey
Gibt den Verweis an, in bezug auf welchen strKey der Batch-Datei hinzugefügt wird.
|
|
|
nOption
Gibt an, an welcher Stelle in der Datei die Zeile eingefügt werden soll. Übergeben Sie hier eine der folgenden vorgegebenen Konstanten als Parameter
n$BFO_BEFORE
Die Anweisung wird vor der ersten Zeile hinzugefügt, die strPositKey enthält. Ist strPositKey ein Null-String (””), wird die Anweisung als erste Zeile der Datei hinzugefügt.
n$BFO_AFTER
Die Anweisung wird nach der letzten Zeile hinzugefügt, die strPositKey enthält. Ist strPositKey ein Null-String (””), wird die Anweisung als letzte der Datei hinzugefügt.
n$ BFO_REPLACE:
Die Anweisung ersetzt eine vorhandenen Zeile der Datei. Existieren mehrere Zeilen mit dem selben Verweis, wird nur die letzte Zeile ersetzt. Existiert strKey nicht in der Datei, wird nach strPositKey eine neue Zeile eingefügt. Ist strPositKey ein Null-String (””), wird die Anweisung als letzte der Datei hinzugefügt.
Ist die einzufügende Anweisungen kein SET Befehl, übergibt man in strKey ein Null-String (””), übergibt man den gesamten Befehl in strValue und fügt OR mit der Konstanten COMMAND und einer der anderen nOption ein, wie unten dargestellt:
n$BFO_CBEFORE: BEFORE | COMMAND
BatchAdd ("", "PAUSE", “”, n$BFO_CBEFORE );
n$BFO_CREPLACE: REPLACE | COMMAND
BatchAdd ("", "PAUSE", “”, n$BFO_CREPLACE);
n$ BFO_CAFTER: AFTER | COMMAND
BatchAdd ("", "PAUSE", “”, n$ BFO_CAFTER );
|
|
Rückgabewert
|
Fehlerhandling übernimmt die InstallEngine.
|
|
Beschreibung
|
Diese Funktion führt zum Aufruf der InstallShieldÓ - Funktion gleichen Namens.
|
|
Funktionsart
|
infraSetupFunktion
|