Rubrique précédente: CreateDetectedSoftwareProductRubrique suivante: CreateDetectedSoftwarePatch


CreateDetectedSoftwareRelease

La fonction CreateDetectedSoftwareRelease ajoute un enregistrement au fichier de sortie de détection de logiciels lorsque le script détecte une version finale d'un produit sur l'ordinateur de l'agent.

Remarque : dmscript ajoute l'enregistrement uniquement s'il trouve l'enregistrement de produit associé dans la MDB.

Cette fonction présente le format suivant :

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

Exemple :

CreateDetectedSoftwareRelease ("Microsoft Windows 7 Edition Intégrale", "6.1", "Microsoft Windows 7 Edition Intégrale x64 64 fr-fr", "6.1.7600", "VersionNumber=6.1.7600 |Language=fr-fr |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Systèmes d'exploitation |Description=Version finale Microsoft Windows 7")

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.

Remarque : L'étiquette de version est utilisée pour identifier le produit avec son nom. Une valeur vide est permise et est considérée comme renseignant un produit avec une version vide.

ReleaseName

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

Remarque : Une version finale peut avoir le même nom que le produit. Toutefois, les scripts de signatures intelligentes prennent en charge des noms de version finale différents pour aider à associer plusieurs versions finales au même produit. Le nom de version finale et l'étiquette de version doivent être uniques dans chaque chaîne de script de signatures intelligentes. Deux versions finales du même nom dans le même script de signatures intelligentes ne sont traitées comme la même version finale que si elles partagent les mêmes définitions parentes, indépendamment des paramètres facultatifs. Si la même version finale est détectée à l'aide de deux scripts de signatures intelligentes différents, deux enregistrements détectés distincts sont créés, un pour chaque script de signatures intelligentes.

ReleaseVersionLabel

Indique l'étiquette de version de la version finale.

Remarque : L'étiquette de version est utilisée pour identifier la version finale avec son nom. Une valeur vide est permise et est considérée comme renseignant une version finale avec une version vide.

OptionalProperties

Spécifie les propriétés facultatives associées à la version finale logicielle détectée. Les propriétés facultatives disponibles pour les versions finales sont les suivantes :

VersionNumber

Indique le numéro de version finale.

Langue

Spécifie la langue dans laquelle la version finale est installée.

Bitness

Spécifie si la version finale utilise l'architecture 32 ou 64 bits.

Architecture

Spécifie le nom de l'architecture.

Manufacturer

Spécifie le nom du fabricant de la version finale.

Catégorie

Spécifie la catégorie de la version finale.

ManufacturerUUID

Spécifie l'UUID du fabricant de la version finale.

CategoryUUID

Spécifie l'UUID de la catégorie de la version finale.

Description

Décrit la version finale.

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.