IDiaSourceFile::get_checksumIDiaSourceFile::get_checksum

Récupère les octets de la somme de contrôle.Retrieves the checksum bytes.

SyntaxeSyntax

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

ParamètresParameters

cbData
[in] Taille de la mémoire tampon de données, en octets.[in] Size of the data buffer, in bytes.

pcbData
[out] Retourne le nombre d’octets de la somme de contrôle.[out] Returns the number of checksum bytes. Ce paramètre ne peut pas être NULL.This parameter cannot be NULL.

data
[dans, out] Une mémoire tampon est remplie avec les octets de la somme de contrôle.[in, out] A buffer that is filled with the checksum bytes. Si ce paramètre est NULL, puis pcbData retourne le nombre d’octets requis.If this parameter is NULL, then pcbData returns the number of bytes required.

Valeur de retourReturn Value

En cas de réussite, retourne S_OK; sinon, retourne un code d’erreur.If successful, returns S_OK; otherwise, returns an error code.

NotesRemarks

Pour déterminer le type d’algorithme de somme de contrôle qui a été utilisé pour générer les octets de la somme de contrôle, appelez le IDiaSourceFile::get_checksumType (méthode).To determine the type of checksum algorithm that was used to generate the checksum bytes, call the IDiaSourceFile::get_checksumType method.

La somme de contrôle est généralement générée à partir de l’image du fichier source pour les modifications dans le fichier source sont reflétées dans les modifications effectuées dans les octets de la somme de contrôle.The checksum is typically generated from the image of the source file so changes in the source file are reflected in changes in the checksum bytes. Si les octets de la somme de contrôle ne correspondent pas généré à partir de l’image chargée du fichier, puis le fichier doit être considérée comme une somme de contrôle endommagés ou falsifiés.If the checksum bytes do not match a checksum generated from the loaded image of the file, then the file should be considered damaged or tampered with.

Les sommes de contrôle standards ne sont jamais plus de 32 octets de taille mais ne supposent pas qui est la taille maximale d’une somme de contrôle.Typical checksums are never more than 32 bytes in size but do not assume that is the maximum size of a checksum. Définir le data paramètre NULL pour obtenir le nombre d’octets requis pour récupérer la somme de contrôle.Set the data parameter to NULL to get the number of bytes required to retrieve the checksum. Allouer une mémoire tampon de la taille appropriée, puis appelez cette méthode une fois de plus, avec la nouvelle mémoire tampon.Then allocate a buffer of the appropriate size and call this method once more with the new buffer.

Voir aussiSee Also

IDiaSourceFile IDiaSourceFile
IDiaSourceFile::get_checksumTypeIDiaSourceFile::get_checksumType