Rubrique précédente: CreateDetectedSoftwareReleaseInstanceRubrique suivante: LogDetectedSoftwareError


CreateDetectedSoftwarePatchInstance

La fonction CreateDetectedSoftwarePatchInstance ajoute un enregistrement au fichier de sortie de détection de logiciels lorsque le script détecte une instance d'un patch particulier.

Format de la fonction :

CreateDetectedSoftwarePatchInstance (ProductName as String, ProductVersionLabel, as String, ReleaseName as String, ReleaseVersionLabel as String, PatchName as String, PatchVersionLabel as String, OptionalProperties as String) as an integer

Exemple : CreateDetectedSoftwarePatchInstance

CreateDetectedSoftwarePatchInstance ("Microsoft Windows 7 Edition Intégrale", "6.1", "Microsoft Windows 7 Edition Intégrale x64 64 fr-fr", "6.1.7600", "KB971033 x64 64 fr-fr", "", "Origin=Forward Inc |TrustLevel=5 |")

Remarque : Cette fonction doit être invoquée après la fonction CreateDetectedSoftwarePatch dans chaque script. Vous pouvez appeler la fonction CreateDetectedSoftwarePatchInstance autant de fois qu'il existe d'instances. Chaque instance obtient un enregistrement de logiciel détecté distinct.

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

Paramètres d'entrée

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

ProductName

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

ProductVersionLabel

Indique l'étiquette de version du produit.

ReleaseName

Spécifie le nom de la version finale à laquelle le patch appartient. Vous devez avoir invoqué la fonction CreateDetectedSoftwareRelease pour cette version finale dans le script.

ReleaseVersionLabel

Indique l'étiquette de la version finale.

PatchName

Spécifie le nom du patch logiciel détecté. Vous devez avoir invoqué la fonction CreateDetectedSoftwarePatch pour cette version finale dans le script.

PatchVersionLabel

Indique l'étiquette de version du patch.

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.

Etiquette

Spécifie une étiquette unique pour l'instance.

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 que ce paramètre ou d'autres paramètres obligatoires transmis à 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.