取得檔案的雜湊值 (如果使用雜湊)。
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
當 pbFileHash 太小時，為 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在這種情況下，所需的位元組數目是在 pcbFileHash 中傳回。
備註
必須將 FILESYNC_INIT_FLAG_USE_HASHING 傳遞給 IFileSyncProvider::Initialize 方法，才會計算檔案的雜湊值並且使用於衝突偵測。如需詳細資訊，請參閱 FILESYNC_INIT_FLAGS 列舉。