Gültig unter Windows und Unix
Die Funktion "CcnfSetParameterStr" ändert den Wert eines vorhandenen allgemeinen Konfigurationsparameters, der den Datentyp Zeichenfolge aufweist.
Diese allgemeine Konfigurationsfunktion hat folgendes Format:
CcnfSetParameterStr(Parametername as string, Value as string) as boolean
Parametername
Name eines allgemeinen Konfigurationsparameters einschließlich absoluter Pfadangabe (zum Beispiel: "itrm/rc/protocols/encrypt/dll")
Wert
Zeichenfolgewert von "Parametername"
Der Rückgabewert der Funktion ist ein boolescher Wert. Bei erfolgreicher Ausführung gibt die Funktion TRUE zurück. Wenn die Funktion fehlschlägt, wird ein Fehler in die Protokolldatei geschrieben.
Die Richtigkeit des Wertes wird nicht geprüft.
Beispiel: Funktion "CcnfSetParameterStr"
In diesem Beispiel wird ein comstore-Parameter verwendet, der im Implementierungshandbuch im Kapitel "Zuordnungen zwischen "asm.cnf" und "comstore.xml"" beschrieben wird.
if CcnfSetParameterStr("itrm/usd/shared/nos", "newValue") then
Print("value of itrm/usd/shared/nos was modified" )
else
Print("CcnfSetParameterStr failed")
endif
Wenn Sie benutzerdefinierte Intellisigs erstellen, rufen Sie die DMScript-Funktionen innerhalb Ihres Intellisig-Skript auf, um über Softwaredatensätze zu berichten, die auf dem Agent-Computer gefunden wurden. DMScript stellt integrierte Funktionen bereit, die Datensätze zu gefundener Software in einer Ausgabedatei aufzeichnen.
Hinweis: DMScript ist eine Skripterstellungssprache, die der Ausführung von Befehlen auf Agenten dient. Weitere Informationen zu DMScript finden Sie im Handbuch Desktop Management Scripting-Sprache im Bookshelf zu CA IT Client Manager.
Das Intellisig-Skript muss die Funktionen in der folgenden Reihenfolge aufrufen:
Die OpenDetectedSoftwareOutputFiles-Funktion erstellt eine leere Softwareerkennungs-Ausgabedatei für das Intellisig. Eine Softwareerkennungs-Ausgabedatei enthält alle für ein Intellisig gefundenen Datensätze. Wenn das Intellisig-Skript auf dem Agent-Computer ausgeführt wird, erstellt die OpenDetectedSoftwareOutputFiles-Funktion eine Ausgabedatei, in der jede vom Intellisig gefundene Software gespeichert wird. Wenn zum Beispiel ein Intellisig Definitionen für alle Adobe-Produkte, Releases und Patches einschließt, können Sie alle Adobe-Erkennungsdatensätze in die gleiche Ausgabedatei schreiben.
Hinweis: Das Intellisig-Skript muss die OpenDetectedSoftwareOutputFiles-Funktion aufrufen, ungeachtet dessen, ob das Intellisig Software findet. Ein Intellisig, der keine Ausgabedatei erstellt, generiert einen Fehler während Ausführung.
Diese Funktion hat das folgende Format:
OpenDetectedSoftwareOutputFiles (IntellisigUUID als String, Version als String, Name als String) als Integer
Beispiel: OpenDetectedSoftwareOutputFiles
OpenDetectedSoftwareOutputFiles ("A7C1E14A-7C93-4E17-B4E5-45B796717F49", "V1", "OS Detection for Windows")
Eingabeparameter
Diese Funktion hat die folgenden Eingabeparameter:
Gibt die universelle eindeutige ID (UUID) des Intellisigs an. Die Funktion erstellt eine Softwareerkennungs-Ausgabedatei mit der angegebenen UUID als Dateiname.
Gibt die Versionsnummer des Intellisigs an.
Gibt den Namen des Intellisigs an. Verwenden Sie einen Namen, der das Intellisig beschreibt.
Rückgabewerte
Zeigt an, dass die Funktion den Vorgang erfolgreich abgeschlossen hat.
Zeigt an, dass ein oder mehrere obligatorische Parameter leer sind, die an die Funktion übergeben wurden.
Zeigt an, dass die Funktion die Datei nicht öffnen konnte. Weitere Informationen finden Sie in der Protokolldatei.
Die CreateDetectedSoftwareProduct-Funktion fügt einen Datensatz zur Softwareerkennungs-Ausgabedatei hinzu, wenn das Skript ein Produkt findet, das sich auf das Intellisig auf dem Agent-Computer bezieht.
Diese Funktion hat das folgende Format:
CreateDetectedSoftwareProduct (ProductName as String, ProductVersion as String, OptionalProperties as String) as integer
Beispiel: CreateDetectedSoftwareProduct
CreateDetectedSoftwareProduct(("Microsoft Windows 7 Ultimate", "6.1", "VersionNumber=6.1 |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=The Microsoft Windows 7 Product")
Hinweis: Diese Funktion muss aufgerufen werden, bevor man die CreateDetectedSoftwareRelease-Funktion aufruft, die den Release des Produkts erstellt.
Eingabeparameter
Diese Funktion hat die folgenden Eingabeparameter:
Gibt den Produktnamen der erkannten Software an.
Hinweis: Der Produktname muss innerhalb des Intellisigs eindeutig sein. Zwei Produkte mit demselben Namen innerhalb eines Intellisigs werden als das gleiche Produkt betrachtet, ungeachtet der optionalen Parameter. Wenn das gleiche Produkt mithilfe zwei verschiedener Intellisigs gefunden wird, werden zwei getrennte gefundene Datensätze erstellt, einer für jedes Intellisig.
Gibt die Versionsbezeichnung des Produkts an.
Hinweis: Die Versionsbezeichnung wird verwendet, um das Produkt zusammen mit seinem Namen zu identifizieren. Ein leerer Wert ist erlaubt und wird als ein Produkt mit einer leeren Version betrachtet.
Gibt die optionalen Eigenschaften an, die dem gefundenen Softwareprodukt zugeordnet werden. Folgende optionale Eigenschaften sind für Produkte verfügbar:
Gibt die Versionsnummer des Produkts an. Versionsnummer ist ein numerischer Wert, getrennt durch Punkte, zum Beispiel 6.1.7600.0.
Gibt die Sprache an, in der das Produkt installiert ist.
Gibt an, ob das Produkt 32-Bit- oder 64-Bit-Architektur verwendet. Gültige Werte sind 32 und 64.
Gibt den Architekturnamen an, den das Produkt verwendet. Eine vollständige Liste der Architekturen finden Sie unter Unterstützte Architekturen.
Gibt den Namen des Produktherstellers an.
Gibt den Namen der Produktkategorie an.
Gibt die UUID des Produktherstellers an.
Gibt die UUID der Produktkategorie an.
Gibt die Beschreibung des Produkts an.
Rückgabewerte
Zeigt an, dass die Funktion den Vorgang erfolgreich abgeschlossen hat.
Zeigt an, dass ein oder mehrere obligatorische Parameter leer sind, die an die Funktion übergeben wurden.
Zeigt an, dass die Funktion nicht in die Datei schreiben konnte. Weitere Informationen finden Sie in der Protokolldatei.
Die CreateDetectedSoftwareRelease-Funktion fügt einen Datensatz zur Softwareerkennungs-Ausgabedatei hinzu, wenn das Skript einen Release eines Produkt auf dem Agent-Computer findet.
Hinweis: DMScript fügt den Datensatz nur hinzu, wenn es den zugehörigen Produktdatensatz in der MDB findet.
Diese Funktion hat das folgende Format:
CreateDetectedSoftwareRelease (ProductName als String, ProductVersionLabel als String, ReleaseName als String, ReleaseVersionLabel als String, OptionalProperties als String) als Integer
Beispiel: CreateDetectedSoftwareRelease
CreateDetectedSoftwareRelease ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "VersionNumber=6.1.7600 |Language=en-us |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=The Microsoft Windows 7 Release")
Eingabeparameter
Diese Funktion hat die folgenden Eingabeparameter:
Gibt den Produktnamen an, zu dem der Release gehört. Sie müssen die CreateDetectedSoftwareProduct-Funktion für dieses Produkt innerhalb des Skripts aufgerufen haben.
Gibt die Versionsbezeichnung des Produkts an.
Hinweis: Die Versionsbezeichnung wird verwendet, um das Produkt zusammen mit seinem Namen zu identifizieren. Ein leerer Wert ist erlaubt und wird als ein Produkt mit einer leeren Version betrachtet.
Gibt den Namen der erkannten Software an.
Hinweis: Ein Release kann denselben Namen wie das Produkt haben. Allerdings unterstützen Intellisigs unterschiedliche Releasenamen, um dabei zu helfen, mehrere Releases zum gleichen Produkt zuzuordnen. Der Releasename und die Versionsbezeichnung müssen innerhalb jeder Intellisig-Kette eindeutig sein. Zwei Releases mit demselben Namen innerhalb eines Intellisigs werden nur dann als der gleiche Release betrachtet, wenn sie die gleichen übergeordneten Definitionen nutzen, ungeachtet der optionalen Parameter. Wenn der gleiche Release mithilfe zwei verschiedener Intellisigs gefunden wird, werden zwei getrennte gefundene Datensätze erstellt, einer für jedes Intellisig.
Gibt die Versionsbezeichnung des Release an.
Hinweis: Die Versionsbezeichnung wird verwendet, um den Release zusammen mit seinem Namen zu identifizieren. Ein leerer Wert ist erlaubt und wird als ein Release mit einer leeren Version betrachtet.
Gibt die dem erkannten Softwarerelease zugeordneten optionalen Eigenschaften an. Folgende optionale Eigenschaften sind für Releases verfügbar:
Gibt die Versionsnummer des Release an. Versionsnummer ist ein numerischer Wert, getrennt durch Punkte, zum Beispiel 6.1.7600.0.
Gibt die Sprache an, in der der Release installiert ist.
Gibt an, ob der Release 32-Bit- oder 64-Bit-Architektur verwendet. Gültige Werte sind 32 und 64.
Gibt den Architekturnamen an, den der Release verwendet. Eine vollständige Liste der Architekturen finden Sie unter Unterstützte Architekturen.
Gibt den Namen des Releaseherstellers an.
Gibt den Namen der Releasekategorie an.
Gibt die UUID des Releaseherstellers an.
Gibt die UUID der Releasekategorie an.
Gibt die Beschreibung des Release an.
Rückgabewerte
Zeigt an, dass die Funktion den Vorgang erfolgreich abgeschlossen hat.
Zeigt an, dass ein oder mehrere obligatorische Parameter leer sind, die an die Funktion übergeben wurden.
Zeigt an, dass die Funktion nicht in die Datei schreiben konnte. Weitere Informationen finden Sie in der Protokolldatei.
Die CreateDetectedSoftwarePatch-Funktion fügt einen Datensatz zur Softwareerkennungs-Ausgabedatei hinzu, wenn das Skript einen Patch eines bestimmten Release auf dem Agent-Computer findet. Fügen Sie diese Funktion für jeden Patch hinzu, den Sie ins Intellisig-Skript aufgenommen haben.
Diese Funktion hat das folgende Format:
CreateDetectedSoftwarePatch (ProductName als String, ProductVersionLabel als String, ReleaseName als String, ReleaseVersionLabel als String, PatchName als String, PatchVersionLabel als String, OptionalProperties als String) als Integer
Beispiel: CreateDetectedSoftwarePatch
CreateDetectedSoftwarePatch ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "KB971033 x64 64 en-us", "Language=en-us |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=The Microsoft Windows 7 Activation Checker Update")
Hinweis: Diese Funktion muss aufgerufen werden, nachdem man die CreateDetectedSoftwareRelease-Funktion innerhalb jedes Skripts aufgerufen hat.
Eingabeparameter
Diese Funktion hat die folgenden Eingabeparameter:
Gibt den Namen des Produkts an, zu dem der Patch gehört. Sie müssen die CreateDetectedSoftwareProduct-Funktion für dieses Produkt innerhalb des Skripts aufgerufen haben.
Gibt die Versionsbezeichnung des Produkts an.
Hinweis: Die Versionsbezeichnung wird verwendet, um das Produkt zusammen mit seinem Namen zu identifizieren. Ein leerer Wert ist erlaubt und wird als ein Produkt mit einer leeren Version betrachtet.
Gibt den Namen des Release an, zu dem der Patch gehört. Sie müssen die CreateDetectedSoftwareRelease-Funktion für diesen Release innerhalb des Skripts aufgerufen haben.
Gibt die Versionsbezeichnung des Release an.
Hinweis: Die Versionsbezeichnung wird verwendet, um den Release zusammen mit seinem Namen zu identifizieren. Ein leerer Wert ist erlaubt und wird als ein Release mit einer leeren Version betrachtet.
Gibt den Namen des gefundenen Softwarepatches an.
Hinweis: Ein Patch kann nicht denselben Namen wie der Release oder das Produkt haben, zu dem er gehört. Der Patchname und Versionsbezeichnung müssen innerhalb jeder Intellisig-Softwaredefinitionskette eindeutig sein. Zwei Patches mit demselben Namen innerhalb eines Intellisigs werden nur dann als der gleiche Patch betrachtet, wenn sie die gleichen übergeordneten Definitionen nutzen, ungeachtet der optionalen Parameter. Wenn der gleiche Patch mithilfe zwei verschiedener Intellisigs gefunden wird, werden zwei getrennte gefundene Datensätze erstellt, einer für jedes Intellisig.
Gibt die Versionsbezeichnung des Patches an.
Hinweis: Die Versionsbezeichnung wird verwendet, um den Patch zusammen mit seinem Namen zu identifizieren. Ein leerer Wert ist erlaubt und wird als ein Patch mit einer leeren Version betrachtet.
Gibt die optionalen Eigenschaften an, die dem gefundenen Softwarepatch zugeordnet sind. Folgende optionale Eigenschaften sind für Patches verfügbar:
Gibt die Versionsnummer des Patches an. Versionsnummer ist ein numerischer Wert, getrennt durch Punkte, zum Beispiel 6.1.7600.0.
Gibt die Sprache an, in der der Patch installiert ist.
Gibt an, ob der Patch 32-Bit- oder 64-Bit-Architektur verwendet. Gültige Werte sind 32 und 64.
Gibt den Architekturnamen an, den der Patch verwendet. Eine vollständige Liste der Architekturen finden Sie unter Unterstützte Architekturen.
Gibt den Namen des Patchherstellers an.
Gibt den Namen der Patchkategorie an.
Gibt die UUID des Patchherstellers an.
Gibt die UUID der Patchkategorie an.
Gibt die Patchbeschreibung an.
Rückgabewerte
Zeigt an, dass die Funktion den Vorgang erfolgreich abgeschlossen hat.
Zeigt an, dass ein oder mehrere obligatorische Parameter leer sind, die an die Funktion übergeben wurden.
Zeigt an, dass die Funktion nicht in die Datei schreiben konnte. Weitere Informationen finden Sie in der Protokolldatei.
Die CreateDetectedSoftwareReleaseInstance-Funktion fügt einen Datensatz zur Softwareerkennungs-Ausgabedatei hinzu, wenn das Skript eine Instanz eines bestimmten Release auf dem Agent-Computer findet.
Diese Funktion hat das folgende Format:
CreateDetectedSoftwareReleaseInstance (ProductName als String, ProductVersionLabel als String, ReleaseName als String, ReleaseVersionLabel als String, OptionalProperties als String) als Integer
Beispiel: CreateDetectedSoftwareReleaseInstance
CreateDetectedSoftwareReleaseInstance ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "Origin=Forward Inc | TrustLevel=5 | InstallPath=C:\Windows | SerialNumber=1234-567-890414-86668 | LastAccessed=2011-11-29:-12:30 |")
Hinweis: Diese Funktion muss aufgerufen werden, nachdem man die CreateDetectedSoftwareRelease-Funktion innerhalb jedes Skripts aufgerufen hat. Die CreateDetectedSoftwareReleaseInstance-Funktion kann so oft aufgerufen werden, wie Instanzen gefunden werden, und jede Instanz erhält einen separaten erkannten Softwaredatensatz.
Hinweis: Wenn zwei verschiedene Intellisigs die gleiche Softwareinstanz finden, werden zwei erkannte Softwaredatensätze erstellt, einer für jedes Intellisig.
Eingabeparameter
Diese Funktion hat die folgenden Eingabeparameter:
Gibt den Produktnamen an, zu dem der Release gehört. Sie müssen die CreateDetectedSoftwareProduct-Funktion für dieses Produkt innerhalb des Skripts aufgerufen haben.
Gibt die Versionsbezeichnung des Produkts an.
Gibt den Namen der erkannten Software an.
Gibt die Versionsbezeichnung des Release an.
Gibt die der erkannten Softwareinstanz zugeordneten optionalen Eigenschaften an. Die folgenden optionalen Eigenschaften sind für Instanzen verfügbar:
Gibt die Produkt-UUID an, die vom Skript gefunden wird, zum Beispiel die Produkt-GUID eines MSI-Pakets.
Gibt eine eindeutige Bezeichnung für diese Instanz an, zum Beispiel den Microsoft SQL Server-Instanznamen.
Gibt den Namen des Intellisig-Erstellers an.
Gibt die Vertrauensstufe des Erstellers des Intellisigs, des Skripts oder beiden an.
Gibt den Pfad zum Produktinstallationsverzeichnis oder die ausführbare Datei auf dem Agent-Computer an.
Gibt die Seriennummer der Instanz an.
Gibt Datum und Uhrzeit des letzten Zugriffs auf die Instanz an. Geben Sie den Wert im folgenden Format an: jjjj-mm-tt-hr:mm. Es wird angenommen, dass dieser Wert in Ortszeit ist.
Hinweis: Alle anderen Funktionen in dmscript, die sich mit Zeit befassen, funktionieren ebenfalls in Ortszeit. Dmscript konvertiert den Zeitwert vor der Ausgabe in Unix-Format (Sekunden seit 1-1-1970 UTC). DSM-Explorer zeigt dies mithilfe der lokalen Zeitzone auf dem Rechner, auf dem er ausgeführt wird, an.
Gibt andere benutzerdefinierte Daten an, die Sie für die Instanz speichern möchten.
Rückgabewerte
Zeigt an, dass die Funktion den Vorgang erfolgreich abgeschlossen hat.
Zeigt an, dass ein oder mehrere obligatorische Parameter leer sind, die an die Funktion übergeben wurden.
Zeigt an, dass die Funktion nicht in die Datei schreiben konnte. Weitere Informationen finden Sie in der Protokolldatei.
Die CreateDetectedSoftwarePatchInstance-Funktion fügt einen Datensatz zur Softwareerkennungs-Ausgabedatei hinzu, wenn das Skript eine Instanz eines bestimmten Patch auf dem Agent-Computer findet.
Diese Funktion hat das folgende Format:
CreateDetectedSoftwarePatchInstance (ProductName als String, ProductVersionLabel als String, ReleaseName als String, ReleaseVersionLabel als String, PatchName als String, PatchVersionLabel als String, OptionalProperties als String) als Integer
Beispiel: CreateDetectedSoftwarePatchInstance
CreateDetectedSoftwarePatchInstance ("Microsoft Windows 7 Ultimate", "6.1", "Microsoft Windows 7 Ultimate x64 64 en-us", "6.1.7600", "KB971033 x64 64 en-us", "", "Origin=Forward Inc |TrustLevel=5 |")
Hinweis: Diese Funktion muss aufgerufen werden, nachdem man die CreateDetectedSoftwarePatch-Funktion innerhalb jedes Skripts aufgerufen hat. Die CreateDetectedSoftwarePatchInstance-Funktion kann so oft aufgerufen werden, wie Instanzen gefunden werden, und jede Instanz erhält einen separaten erkannten Softwaredatensatz.
Hinweis: Wenn zwei verschiedene Intellisigs die gleiche Softwareinstanz finden, werden zwei erkannte Softwaredatensätze erstellt, einer für jedes Intellisig.
Eingabeparameter
Diese Funktion hat die folgenden Eingabeparameter:
Gibt den Namen des Produkts an, zu dem der Patch gehört. Sie müssen die CreateDetectedSoftwareProduct-Funktion für dieses Produkt innerhalb des Skripts aufgerufen haben.
Gibt die Versionsbezeichnung des Produkts an.
Gibt den Namen des Release an, zu dem der Patch gehört. Sie müssen die CreateDetectedSoftwareRelease-Funktion für diesen Release innerhalb des Skripts aufgerufen haben.
Gibt die Versionsbezeichnung des Release an.
Gibt den Namen des gefundenen Softwarepatches an. Sie müssen die CreateDetectedSoftwarePatch-Funktion für diesen Release innerhalb des Skripts aufgerufen haben.
Gibt die Versionsbezeichnung des Patches an.
Gibt die der erkannten Softwareinstanz zugeordneten optionalen Eigenschaften an. Die folgenden optionalen Eigenschaften sind für Instanzen verfügbar:
Gibt die Produkt-UUID an, die vom Skript gefunden wird, zum Beispiel die Produkt-GUID eines MSI-Pakets.
Gibt eine eindeutige Bezeichnung für diese Instanz an, zum Beispiel den Microsoft SQL Server-Instanznamen.
Gibt den Namen des Intellisig-Erstellers an.
Gibt die Vertrauensstufe des Erstellers des Intellisigs, des Skripts oder beiden an.
Gibt den Pfad zum Produktinstallationsverzeichnis oder die ausführbare Datei auf dem Agent-Computer an.
Gibt die Seriennummer der Instanz an.
Gibt Datum und Uhrzeit des letzten Zugriffs auf die Instanz an. Geben Sie den Wert im folgenden Format an: jjjj-mm-tt:hr:mm. Es wird angenommen, dass dieser Wert in Ortszeit ist. Hinweis: Alle anderen Funktionen in dmscript, die sich mit Zeit befassen, funktionieren ebenfalls in Ortszeit. Dmscript konvertiert den Zeitwert vor der Ausgabe in Unix-Format (Sekunden seit 1-1-1970 UTC). DSM-Explorer zeigt dies mithilfe der lokalen Zeitzone auf dem Rechner, auf dem er ausgeführt wird, an.
Gibt andere benutzerdefinierte Daten an, die Sie für die Instanz speichern möchten.
Rückgabewerte
Zeigt an, dass die Funktion den Vorgang erfolgreich abgeschlossen hat.
Zeigt an, dass ein oder mehr obligatorische Parameter, die an die Funktion übergeben wurden, leer sind.
Zeigt an, dass die Funktion nicht in die Datei schreiben konnte. Weitere Informationen finden Sie in der Protokolldatei.
Die LogDetectedSoftwareError-Funktion speichert die Fehlermeldungen in einer Fehlerprotokolldatei ab. Die Funktion erzeugt lokalisierbare Fehlermeldungen. Rufen Sie diese Funktion auf, um Fehler zu behandeln, die von Erstellungsfunktionen generiert wurden. Die Engine liest diese Fehlermeldungen und zeigt sie in DSM-Explorer an.
Diese Funktion hat das folgende Format:
LogDetectedSoftwareError (MessageID as String, Properties as String)
Beispiel: LogDetectedSoftwareError
LogDetectedSoftwareError("ISE:00400","PARAM5=Microsoft Windows 7 Ultimate x64 64 en-us|PARAM6=VersionNumber=6.1.7600 |VersionLabel=6.1.7600 |Language=en-us |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=The Microsoft Windows 7 Product|PARAM7=SWDETECT_BADARGS");
Der vorangehende Beispielcode fügt die folgende Meldung zur Protokolldatei hinzu:
Intellisig Microsoft Windows 7 version 6.1.7600, UUID A7C1E14A-7C93-4E17-B4E5-45B796717F49, script win7.xml, Failed to create software product. The parameters were ProductName:Microsoft Windows 7 Ultimate x64 64 en-us OptionalProperties : VersionNumber=6.1.7600 |VersionLabel=6.1.7600 |Language=en-us |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Operating Systems |Description=Das Microsoft Windows 7-Produkt. Return Code : SWDETECT_BADARGS
Eingabeparameter
Diese Funktion hat die folgenden Eingabeparameter:
Gibt den Fehlercode an. Weitere Informationen zu verfügbaren Fehlercodes finden Sie unter Fehlercodes und optionale Eigenschaften.
Gibt eine Liste von Eigenschaften an, die erforderlich sind, um eine formatierte Meldungszeichenfolge zu erstellen. Normalerweise geben Sie die Parameter an, die an die jeweiligen Erstellungsfunktionen übergeben werden, die Sie bearbeiten. Die Parameter müssen mit dem Fehlertext übereinstimmen. Den genauen Fehlertext und die Funktionssyntax finden Sie unter Fehlercodes und optionale Eigenschaften. Der Fehlertext verwendet PARAM1 bis PARAM8, um die Meldungszeichenfolge zu erstellen. Wenn die Zeichenfolge keine Parameter/Wertpaare enthält, wird die Zeichenfolge unverändert angezeigt. Die Parameter PARAM1 bis PARAM4 sind automatisch den folgenden Werten zugewiesen:
Die Werte für Parameter PARAM5 bis PARAM8 unterscheiden sich je nach der Erstellungsfunktion, die Sie bearbeiten. Wenn Sie zum Beispiel den Fehler der CreateDetectedSoftwareProduct-Funktion verarbeiten, sind Fehlercode und Text wie folgt:
Fehlercode: ISE:00400
Fehlertext: Intellisig %1$t version %2$t, UUID %3$t, script %4$t, Failed to create software product. The parameters were ProductName:%5$t OptionalProperties : %6$t. Return Code : %7$t
In diesem Beispiel gibt PARAM5 den Produktnamen an, PARAM6 gibt optionale Eigenschaften an und PARAM7 gibt den Rückgabecode an.
Die CloseDetectedSoftwareOutputFiles-Funktion schließt die von der OpenDetectedSoftwareOutputFiles-Funktion geöffneten Dateien.
Diese Funktion hat das folgende Format:
CloseDetectedSoftwareOutputFiles() as integer
Rückgabewerte
Zeigt an, dass die Funktion den Vorgang erfolgreich abgeschlossen hat.
Zeigt an, dass die Funktion die Datei nicht schließen konnte. Weitere Informationen finden Sie in der Protokolldatei.
|
Copyright © 2013 CA.
Alle Rechte vorbehalten.
|
|