MapFileAndCheckSumA函数计算图像文件的校验和。
ULONG MapFileAndCheckSumA(
IN LPSTR【文件名】, | |
OUT LPDWORD【HeaderSum】, | |
OUT LPDWORD【CheckSum】 | |
); |
参数
【文件名】
要计算校验和的文件的文件名。
【HeaderSum】
指向从图像文件接收原始校验和的变量的指针,如果存在错误,则为零。
【CheckSum】
指向接收计算校验和的变量的指针。
返回值
如果函数成功,返回值为CHECKSUM_SUCCESS。
如果函数失败,则返回值为以下之一:
值 | 含义 |
CHECKSUM_OPEN_FAILURE | 无法打开文件。 |
CHECKSUM_MAP_FAILURE | 无法为文件创建文件映射。 |
CHECKSUM_MAPVIEW_FAILURE | 无法映射文件的视图。 |
CHECKSUM_UNICODE_FAILURE | 无法将文件名转换为UNICODE。 |
备注
在【CheckSum】参数中计算并返回文件的新校验和。此函数由创建或修改可执行映像的任何应用程序使用。Windows NT内核模式驱动程序和某些系统DLL需要校验和。如果打开了用于校验和的链接器开关,Win32链接器将在链接时计算原始校验和。建议所有图像都有有效的校验和。