IMoniker::Hash-Methode (objidl.h)

Erstellt einen Hashwert unter Verwendung des internen Zustands des Monikers.

Syntax

HRESULT Hash(
  [out] DWORD *pdwHash
);

Parameter

[out] pdwHash

Ein Zeiger auf eine Variable, die den Hashwert empfängt.

Rückgabewert

Diese Methode gibt S_OK zurück, um anzugeben, dass der Hashwert erfolgreich abgerufen wurde.

Hinweise

Hinweise für Anrufer

Sie können den von dieser Methode zurückgegebenen Wert verwenden, um eine Hashtabelle mit Monikern zu verwalten. Der Hashwert bestimmt einen Hashbucket in der Tabelle. Um eine solche Tabelle nach einem angegebenen Moniker zu durchsuchen, berechnen Sie den Hashwert, und vergleichen Sie ihn dann mithilfe von IMoniker::IsEqual mit den Monikern in diesem Hashbucket.

Hinweise für Implementierer

Der Hashwert muss für die Lebensdauer des Monikers konstant sein. Zwei Moniker, die mit IMoniker::IsEqual als gleich vergleichen, müssen auf denselben Wert hashen.

Das Marshallen und anschließende Aufheben der Entmarsung eines Monikers sollte keine Auswirkungen auf den Hashwert haben. Daher sollte ihre Implementierung von IMoniker::Hash nur auf dem internen Zustand des Monikers basieren, nicht auf seiner Speicheradresse.

Implementierungsspezifische Hinweise

Implementierung	Hinweise
Anti-Moniker	Diese Methode berechnet einen Hashwert für den Moniker.
Moniker der Klasse	Diese Methode berechnet einen Hashwert für den Moniker und gibt S_OK zurück. Kann E_INVALIDARG zurückgeben, wenn pdwHash ein ungültiger Zeiger ist.
Dateimoniker	Diese Methode berechnet einen Hashwert für den Moniker.
Generischer zusammengesetzter Moniker	Diese Methode berechnet einen Hashwert für den Moniker.
Elementmoniker	Diese Methode berechnet einen Hashwert für den Moniker.
OBJREF-Moniker	Diese Methode berechnet einen Hashwert für den Moniker.
Zeigermoniker	Diese Methode berechnet einen Hashwert für den Moniker.
URL-Moniker	Erstellt einen Hashwert basierend auf der URL-Zeichenfolge des Monikers. Dieser Hashwert ist identisch, wenn URL-Zeichenfolgen identisch sind, obwohl er auch für verschiedene URL-Zeichenfolgen identisch sein kann. Diese Methode wird verwendet, um Vergleiche zu beschleunigen, indem die Zeit reduziert wird, die zum Aufrufen von IMoniker::IsEqual erforderlich ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	objidl.h

Weitere Informationen

Imoniker