Méthode Installer.FileSignatureInfo

Article
06/13/2023

La méthode FileSignatureInfo de l’objet Installer prend le chemin d’un fichier et retourne un SAFEARRAY d’octets qui représentent le hachage ou le certificat encodé. Les valeurs peuvent ensuite être utilisées pour remplir les tables MsiDigitalSignature, MsiPatchCertificate et MsiDigitalCertificate.

Pour plus d’informations, consultez le type de données SAFEARRAY.

Syntaxe

Installer.FileSignatureInfo(
  FilePath,
  Options,
  Format
)

Paramètres

FilePath

Chemin complet d’un fichier signé numériquement.

Lors du remplissage des tables MsiDigitalSignature et MsiDigitalCertificate, FilePath pointe vers un fichier cabinet signé numériquement. Lors du remplissage des tables MsiPatchCertificate et MsiDigitalCertificate, FilePath pointe vers un correctif signé numériquement.

Options

Indicateurs de cas d’erreur spéciaux.

Indicateur	Signification
msiSignatureOptionInvalidHashFatal 1	Si Options est défini sur msiSignatureOptionInvalidHashFatal, FileSignatureInfo retourne toujours une erreur irrécupérable pour un hachage non valide. Si Options n’est pas défini sur msiSignatureOptionInvalidHashFatal et que Format est défini sur msiSignatureInfoCertificate, FileSignatureInfo ne retourne pas d’erreur pour un hachage non valide.

Format

Informations de signature demandées.

Indicateur	Signification
msiSignatureInfoCertificate 0	Retourne une valeur SAFEARRAY d’octets qui représentent le certificat encodé.
msiSignatureInfoHash 1	Retourne un SAFEARRAY d’octets qui représentent le hachage.

Valeur retournée

Si elle réussit, la méthode retourne un SAFEARRAY d’octets qui contiennent le hachage ou le certificat encodé.

Notes

Pour créer une installation signée entièrement vérifiée en recourant à l’automatisation, utilisez la méthode FileSignatureInfo pour remplir les tables MsiDigitalCertificate, MsiPatchCertificate et MsiDigitalSignature. Pour plus d’informations, consultez Création d’une installation signée entièrement vérifiée en utilisant l’automatisation.

Configuration requise

Condition requise	Valeur
Version	Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
DLL	Msi.dll
IID	IID_IInstaller est défini comme 000C1090-0000-0000-C000-000000000046

Voir aussi

Création d’une installation signée entièrement vérifiée en utilisant l’automatisation
Signatures numériques et Windows Installer
MsiGetFileSignatureInformation

Partager via