IMoniker::Hash

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method returns a hash value.

Syntax

HRESULT Hash( 
  DWORD* pdwHash
);

Parameters

• pdwHash
  [out] Pointer to the hash value.

Return Value

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

Remarks

To determine whether the platform supports this interface, see Determining Supported COM APIs.

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 the IMoniker::IsEqual method.

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.

Requirements

See Also

Reference

IMoniker::IsEqual