IMoniker::Hash 方法 (objidl.h)
使用 Moniker 的內部狀態建立哈希值。
語法
HRESULT Hash(
[out] DWORD *pdwHash
);
參數
[out] pdwHash
接收哈希值的變數指標。
傳回值
這個方法會傳回S_OK,指出已成功擷取哈希值。
備註
來電者的附註
您可以使用這個方法傳回的值來維護Monikers的哈希表。 哈希值會決定數據表中的哈希值區。 若要搜尋這類數據表中的指定Moniker,請計算其哈希值,然後使用 IMoniker::IsEqual將其與該哈希貯體中的Moniker進行比較。實作者的注意事項
哈希值必須是Moniker存留期的常數。 使用 IMoniker::IsEqual 比較為相等的兩個 Moniker 必須哈希為相同的值。封送處理,然後取消封送處理Moniker應該不會影響其哈希值。 因此, IMoniker::Hash 的實作應該只依賴Moniker的內部狀態,而不是依賴其記憶體位址。
實作特定附注
實作 | 備註 |
---|---|
反Moniker | 這個方法會計算Moniker的哈希值。 |
類別Moniker | 這個方法會計算Moniker的哈希值,並傳回S_OK。 如果 pdwHash 是無效的指標,可能會傳回E_INVALIDARG。 |
檔案Moniker | 這個方法會計算Moniker的哈希值。 |
泛型複合Moniker | 這個方法會計算Moniker的哈希值。 |
專案Moniker | 這個方法會計算Moniker的哈希值。 |
OBJREF Moniker | 這個方法會計算Moniker的哈希值。 |
指標 Moniker | 這個方法會計算Moniker的哈希值。 |
URL Moniker | 根據Moniker的URL字串建立哈希值。 當 URL 字串相同時,這個哈希值會相同,但對於不同的 URL 字串也可能相同。 此方法可用來減少呼叫 IMoniker::IsEqual 所需的時間量,以加速比較。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | objidl.h |