Поделиться через


IFileDataRetriever::GetFileHash

Возвращает значение хэша файла, если используется хэширование.

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

Параметры

  • pbFileHash
    [in, out, size_is(*pcbFileHash), unique] Возвращает хэш-значение файла.
  • pcbFileHash
    [in, out] Указывает число байтов в объекте pbFileHash. Возвращает число байтов, необходимое для получения идентификатора, если размер pbFileHash слишком мал, либо возвращает число записанных байтов.

Возвращаемое значение

  • S_OK

  • E_NOTIMPL, если хэширование не применяется.

  • E_POINTER

  • E_INVALIDARG

  • HRESULT_FROM_WIN32(ERROR_MORE_DATA), если размер pbFileHash слишком мал. В этом случае необходимое число байтов возвращается в pcbFileHash.

Замечания

Хэш-значение вычисляется для файла и используется для обнаружения конфликтов только в том случае, если значение FILESYNC_INIT_FLAG_USE_HASHING передано методу IFileSyncProvider::Initialize. Дополнительные сведения см. в разделе Перечисление FILESYNC_INIT_FLAGS.

См. также

Справочник

Интерфейс IFileDataRetriever