Partilhar via

IDiaSourceFile::get_checksum

  • Artigo

Recupera os bytes de soma de verificação.

Sintaxe

HRESULT get_checksum ( 
   DWORD  cbData,
   DWORD* pcbData,
   BYTE   data[]
);

Parâmetros

cbData

[in] Tamanho do buffer de dados, em bytes.

pcbData

[out] Retorna o número de bytes de soma de verificação. O parâmetro não pode ser NULL.

data

[in, out] Um buffer preenchido com os bytes de soma de verificação. Se esse parâmetro for NULL, pcbData retornará o número de bytes necessários.

Valor Retornado

Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro.

Comentários

Para determinar o tipo de algoritmo de soma de verificação que foi usado para gerar os bytes de soma de verificação, chame o método IDiaSourceFile::get_checksumType.

A soma de verificação normalmente é gerada com base na imagem do arquivo de origem para que as alterações no arquivo de origem sejam refletidas em alterações nos bytes de soma de verificação. Se os bytes de soma de verificação não corresponderem a uma soma de verificação gerada com base na imagem carregada do arquivo, o arquivo deverá ser considerado danificado ou adulterado.

Somas de verificação típicas nunca têm mais de 32 bytes de tamanho, mas não assuma que esse seja o tamanho máximo de uma soma de verificação. Defina o parâmetro data como NULL a fim de obter o número de bytes necessários para recuperar a soma de verificação. Em seguida, aloque um buffer do tamanho apropriado e chame esse método mais uma vez com o novo buffer.

Confira também