Skripting Methoden → Ausführen von Kommandos über PyroBatchControl

Wenn Sie Kommandos über andere Programme in PyroBatch ausführen möchten und sofort die Resultate sehen möchten (statt ein komplettes Skript auszuführen und die Protokolldatei später einzusehen), können Sie die Kommandos über die PYROBATCHCONTROL.DLL ausführen lassen, die Sie im PyroBatchFTP Verzeichnis finden.

Diese DLL entält eine Funktion, die von C/C++, den verschiedenen Visual Basic Dialekte und von anderen Entwicklungswerkzeugen wie z.B. Delphi aufgerufen werden kann.

Beispiel-Programme

Unter C:\Programme\PyroBatchFTP\PyroBatchControl finden Sie Beispiel-Code und Projektdateien für Visual C/C++, Visual Basic und MS-Access. Technische Details

Der Name der DLL ist PYROBATCHCONTROL.DLL. Die Funktion wird unter dem Namen _PyroBatch@16 exportiert. Sie hat vier Parameter und liefert einen 32-Bit Wert als Rückgabewert.

Prototyp im C/C++ Stil:

int __stdcall _PyroBatch(const char *app, const char *cmd, char *result, int resultsize);

Deklaration für Visual Basic:

Declare Function PyroBatch Lib "pyrobatchcontrol.dll" Alias "_PyroBatch@16" (ByVal lpApp As String, ByVal lpCmd As String, ByVal lpResult As String, ByVal nResultSize As Long) As Long

Deklaration für Power-Builder:

Function Long PyroBatch(String lpApp, String lpCmd, REF String lpResult, Long nResultSize) Library "pyrobatchcontrol.dll" Alias for "_PyroBatch@16".

Beschreibung der Parameter:

app

Der Name der Anwendung auf die zugegriffen wird, z.B. entweder "PyroBatch" oder "PyroBatchFTP"

cmd

Eines der nachfolgenden Kommandos um sich an PyroBatchFTP anzumelden/abzumelden, oder eines der PyroBatchFTP Kommandos das ausgeführt werden soll.


START
	Startet eine neue Instanz von PyroBatchFTP oder meldet sich an einer momentan laufenden Instanz von PyroBatchFTP an. Falls PyroBatchFTP nicht durch den Installationsassistenten installiert wurde, ist es notwendig, das Verzeichnis, in dem das Program gespeichert ist, in der Form appdir="<directory>" anzugeben, z.B. START appdir="c:\apps\pyrobatch"
HELLO
	Meldet sich an einer momentan laufenden Instanz an (dieser Befehl schlägt fehl, wenn PyroBatchFTP nicht gestartet ist).
BYE
	Meldet sich von PyroBatchFTP ab, lässt PyroBatchFTP aber gestartet (es sei denn ein TerminateAfterScript Kommando wurde ausgeführt).
TERM
	Meldet sich von PyroBatchFTP ab und schließt das Programm.
<other>
	Alle PyroBatchFTP Kommandos

result

Ein Puffer der mit dem Resultat des Befehls gefüllt wird. Das Resultat beginnt immer mit "#nnn ", wobei nnn ein normaler PyroBatch Rückgabewert ist. (200-299 OK, siehe Rückgabewerte)

resultsize

Die maximale Größe des übergebenen Rückgabe-Puffers (result).

return value

Die funktion liefert 0, falls ein Problem aufgetreten ist. Falls das Kommando an PyroBatchFTP weitergeleitet werden konnte liefert die Funktion einen Wert ungleich.
Ein Kommando wurde korrekt ausgeführt, falls die Funktion nicht 0 liefert und der Inhalt des Rückgabe-Puffers (result) mit "#200" - "#299" beginnt.

← Zurück zu Skripting Methoden