Rubrique précédente: CreateDetectedSoftwarePatchRubrique suivante: CreateDetectedSoftwarePatchInstance


CreateDetectedSoftwareReleaseInstance

La fonction CreateDetectedSoftwareReleaseInstance ajoute un enregistrement au fichier de sortie de détection de logiciels lorsque le script détecte une instance d'une version finale particulière.

Format de la fonction :

CreateDetectedSoftwareReleaseInstance (ProductName as String, ProductVersionLabel as String, ReleaseName as String, ReleaseVersionLabel as String, OptionalProperties as String) as an integer.

Exemple :

CreateDetectedSoftwareReleaseInstance ("Microsoft Windows 7 Edition Intégrale", "6.1", "Microsoft Windows 7 Edition intégrale x64 64 fr-fr", "6.1.7600", "Origin=Forward Inc | TrustLevel=5 | InstallPath=C:\Windows | SerialNumber=1234-567-890414-86668 | LastAccessed=2011-11-29:-12:30 |")

Remarque : Cette fonction doit être appelée après la fonction CreateDetectedSoftwareRelease dans chaque script. Vous pouvez appeler la fonction CreateDetectedSoftwareReleaseInstance autant de fois que d'instances trouvées et chaque instance obtient un enregistrement de logiciel détecté distinct.

Remarque : Si deux scripts de signatures intelligentes détectent la même instance de logiciel, deux enregistrements de logiciel détectés sont créés.

Paramètres d'entrée

Cette fonction présente les paramètres d'entrée suivants :

ProductName

Spécifie le nom de produit auquel la version finale appartient. Vous devez avoir appelé la fonction CreateDetectedSoftwareProduct pour ce produit dans le script.

ProductVersionLabel

Indique l'étiquette de version du produit.

ReleaseName

Indique le nom de la version finale du logiciel détecté.

ReleaseVersionLabel

Indique l'étiquette de la version finale.

OptionalProperties

Spécifie les propriétés facultatives associées à l'instance logicielle détectée. Les propriétés facultatives suivantes sont disponibles pour des instances :

ProductGUID

Spécifie l'UUID du produit détecté par le script. Par exemple, le GUID du produit d'un package MSI.

Etiquette

Spécifie une étiquette unique pour l'instance. Par exemple, le nom d'instance Microsoft SQL Server.

Origine

Spécifie le nom du créateur du script de signatures intelligentes.

TrustLevel

Spécifie le niveau de confiance du créateur du script de signatures intelligentes, du script proprement dit ou les deux.

InstallPath

Spécifie le chemin d'accès au répertoire d'installation du produit ou à l'exécutable sur l'ordinateur agent.

SerialNumber

Spécifie le numéro de série de l'instance.

LastAccessed

Spécifie la date et l'heure du dernier accès à l'instance. Spécifiez la valeur au format suivant : jj-mm-aaaa-hh:mm. Cette valeur est supposée utiliser l'heure locale.
Remarque : Toutes les autres fonctions de dmscript qui concernent le temps fonctionnent avec l'heure locale. Dmscript convertit la valeur de temps au format Unix (secondes depuis le 1-1-1970 UTC) avant la sortie. L'explorateur DSM affiche cette heure à l'aide de la zone d'heure locale sur l'ordinateur sur lequel il s'exécute.

CustomData

Spécifie toute autre donnée personnalisée que vous voulez stocker au sujet de l'instance.

Valeurs de retour

CA_SWDETECT_OK

Indique que la fonction a terminé l'opération correctement.

CASWDETECT_BADARGS

Indique qu'un ou plusieurs paramètres obligatoires communiqués à la fonction sont vides.

CASWDETECT_FILE_ERROR

Indique que la fonction n'est pas parvenue à écrire dans le fichier. Reportez-vous au fichier journal pour plus d'informations.