IMoniker::Hash

This method returns a hash value.

At a Glance

Syntax

HRESULT Hash( DWORD * pdwHash );

Parameter

pdwHash

[out] Pointer to the hash value.

Return Value

S_OK indicates that a 32-bit integer hash value was successfully received.

Remarks

Notes to Callers

You can use the value returned by this method to maintain a hash table of monikers. The hash value determines a hash bucket in the table. To search such a table for a specified moniker, calculate its hash value and then compare it to the monikers in that hash bucket using IMoniker::IsEqual.

Notes to Implementers

The hash value must be constant for the lifetime of the moniker. Two monikers that compare as equal using IMoniker::IsEqual must hash to the same value.

Marshaling and then unmarshaling a moniker should have no effect on its hash value. Consequently, your implementation of IMoniker::Hash should rely only on the internal state of the moniker, not on its memory address.