通过

IFileDataRetriever::GetFileHash

  • 项目

获取在使用哈希操作时文件的哈希值。

HRESULT GetFileHash(
  BYTE *pbFileHash,
  ULONG *pcbFileHash);

参数

  • pbFileHash
    [in, out, size_is(*pcbFileHash), unique] 返回文件的哈希值。
  • pcbFileHash
    [in, out] 指定 pbFileHash 中的字节数。如果 pbFileHash 太小，则返回检索 ID 所需的字节数；否则返回写入的字节数。

返回值

  • S_OK

  • 如果未使用哈希算法，则返回值为 E_NOTIMPL。

  • E_POINTER

  • E_INVALIDARG

  • 如果 pbFileHash 太小，则返回值为 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在这种情况下，则在 pcbFileHash 中返回必需的字节数。

备注

仅当 FILESYNC_INIT_FLAG_USE_HASHING 传递给 IFileSyncProvider::Initialize 方法时，才会对文件计算哈希值并将哈希值用于冲突检测。有关详细信息，请参阅 FILESYNC_INIT_FLAGS 枚举。

请参阅

参考

IFileDataRetriever 接口