Condividi tramite

IDiaSourceFile::get_checksum

  • Articolo

Recupera i byte di checksum.

Sintassi

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

Parametri

cbData

[in] Dimensioni del buffer di dati, in byte.

pcbData

[out] Restituisce il numero di byte checksum. Questo parametro non può essere NULL.

data

[in, out] Buffer riempito con i byte di checksum. Se questo parametro è NULL, pcbData restituisce il numero di byte necessari.

Valore restituito

Se ha esito positivo, restituisce S_OK; in caso contrario, restituisce un codice di errore.

Osservazioni:

Per determinare il tipo di algoritmo checksum utilizzato per generare i byte di checksum, chiamare il metodo IDiaSourceFile::get_checksumType .

Il checksum viene in genere generato dall'immagine del file di origine, in modo che le modifiche apportate al file di origine vengano riflesse nelle modifiche apportate ai byte di checksum. Se i byte di checksum non corrispondono a un checksum generato dall'immagine caricata del file, il file deve essere considerato danneggiato o manomesso.

I checksum tipici non sono mai più di 32 byte di dimensione, ma non presuppongono che sia la dimensione massima di un checksum. Impostare il data parametro su NULL per ottenere il numero di byte necessari per recuperare il checksum. Allocare quindi un buffer delle dimensioni appropriate e chiamare questo metodo ancora una volta con il nuovo buffer.

Vedi anche