Compartilhar via


Método Installer.FileSignatureInfo

O método FileSignatureInfo do objeto Installer usa o caminho para um arquivo e retorna um SAFEARRAY de bytes que representa o hash ou o certificado codificado. Os valores podem então ser usados para preencher as tabelas MsiDigitalSignature, MsiPatchCertificate e MsiDigitalCertificate.

Para obter mais informações, confira o Tipo de dados SAFEARRAY.

Sintaxe

Installer.FileSignatureInfo(
  FilePath,
  Options,
  Format
)

Parâmetros

FilePath

Caminho completo para um arquivo assinado digitalmente.

Ao preencher as tabelas MsiDigitalSignature e MsiDigitalCertificate, FilePath aponta para um gabinete assinado digitalmente. Ao preencher as tabelas MsiPatchCertificate e MsiDigitalCertificate, FilePath aponta para um patch assinado digitalmente.

Opções

Sinalizadores especiais de caso de erro.

Sinalizador Significado
msiSignatureOptionInvalidHashFatal
1
Com Options definido como msiSignatureOptionInvalidHashFatal, FileSignatureInfo sempre retorna um erro fatal para um hash inválido.
Se Options não estiver definido como msiSignatureOptionInvalidHashFatal e Format estiver definido como msiSignatureInfoCertificate, FileSignatureInfo não retornará um erro para um hash inválido.

 

Formato

As informações de assinatura solicitadas.

Sinalizador Significado
msiSignatureInfoCertificate
0
Retorna um SAFEARRAY de bytes que representam o certificado codificado.
msiSignatureInfoHash
1
Retorna um SAFEARRAY de bytes que representam o hash.

 

Valor retornado

Se tiver êxito, o método retornará um SAFEARRAY de bytes que contêm o hash ou o certificado codificado.

Comentários

Para criar uma instalação assinada totalmente verificada usando automação, use o método FileSignatureInfo para preencher as tabelas MsiDigitalCertificate, MsiPatchCertificate e MsiDigitalSignature. Para obter mais informações, confira Criação de uma instalação assinada e totalmente verificada usando a automação.

Requisitos

Requisito Valor
Versão
Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
DLL
Msi.dll
IID
O IID_IInstaller é definido como 000C1090-0000-0000-C000-000000000046

Confira também

Criação de uma instalação assinada e totalmente verificada usando automação

Assinaturas Digitais e Windows Installer

MsiGetFileSignatureInformation