Função MsiGetFileSignatureInformationW (msi.h)

A função MsiGetFileSignatureInformation leva o caminho para um arquivo que foi assinado digitalmente e retorna o certificado do signatário e o hash do arquivo. MsiGetFileSignatureInformation pode ser chamado para obter o certificado do signatário e o hash necessários para preencher as tabelas MsiDigitalCertificate, MsiPatchCertificate e MsiDigitalSignature .

Windows Installer 3.0 e posterior: A partir do Windows Installer 3.0, o Windows Installer pode verificar as assinaturas digitais de patches (arquivos .msp) usando as tabelas MsiPatchCertificate e MsiDigitalCertificate . Para obter mais informações, consulte Diretrizes para criação de instalações seguras e aplicação de patch de UAC (controle de conta de usuário).

Windows Installer 2.0: Não há suporte para assinaturas digitais de patches. O Windows Installer 2.0 usa assinaturas digitais como um meio de detectar recursos corrompidos e só pode verificar as assinaturas digitais de gabinetes externos e apenas pelo uso das tabelas MsiDigitalSignature e MsiDigitalCertificate .

Sintaxe

HRESULT MsiGetFileSignatureInformationW(
  [in]      LPCWSTR        szSignedObjectPath,
  [in]      DWORD          dwFlags,
  [out]     PCCERT_CONTEXT *ppcCertContext,
  [out]     LPBYTE         pbHashData,
  [in, out] LPDWORD        pcbHashData
);

Parâmetros

[in] szSignedObjectPath

Ponteiro para uma cadeia de caracteres terminada em nulo especificando o caminho completo para o arquivo que contém a assinatura digital.

[in] dwFlags

Sinalizadores especiais de caso de erro.

[out] ppcCertContext

Contexto de certificado do signatário retornado

[out] pbHashData

Buffer de hash retornado. Esse parâmetro poderá ser NULL se os dados de hash não estiverem sendo solicitados.

[in, out] pcbHashData

Ponteiro para uma variável que especifica o tamanho, em bytes, do buffer apontado pelo parâmetro pbHashData . Esse parâmetro não poderá ser NULL se pbHashData não for NULL. Se ERROR_MORE_DATA for retornado, pbHashData fornecerá o tamanho do buffer necessário para manter os dados de hash. Se ERROR_SUCCESS for retornado, ele fornecerá o número de bytes gravados no buffer de hash. O parâmetro pcbHashData será ignorado se pbHashData for NULL.

Valor retornado

MsiGetFileSignatureInformation também retorna todos os valores de erro win32 mapeados para seu tipo de dados HRESULT equivalente por HRESULT_FROM_WIN32.

Comentários

Ao solicitar apenas o contexto do certificado, um hash inválido na assinatura digital não faz com que MsiGetFileSignatureInformation retorne um erro fatal. Para retornar um erro fatal para um hash inválido, defina o sinalizador MSI_INVALID_HASH_IS_FATAL no parâmetro dwFlags .

O contexto do certificado e as informações de hash são extraídos do arquivo por uma chamada para WinVerifyTrust. O parâmetro ppcCertContext é uma duplicata do contexto de certificado do signatário da assinatura. É responsabilidade do chamador chamar CertFreeCertificateContext para liberar o contexto do certificado quando terminar.

Observe que MsiGetFileSignatureInformation requer a presença do arquivo Wintrust.dll no sistema.

Requisitos

Confira também

Assinaturas digitais e Windows Installer

Tabela MsiDigitalCertificate

Tabela MsiDigitalSignature