IQueryAssociations-Schnittstelle (shlwapi.h)

Macht Methoden verfügbar, die das Abrufen von in der Registrierung gespeicherten Informationen in Verbindung mit der Definition eines Dateityps oder Protokolls und dessen Zuordnen zu einer Anwendung vereinfachen.

Vererbung

Die IQueryAssociations-Schnittstelle erbt von der IUnknown-Schnittstelle . IQueryAssociations verfügt auch über folgende Membertypen:

Methoden

Die IQueryAssociations-Schnittstelle verfügt über diese Methoden.

IQueryAssociations::GetData Sucht nach Binärdaten für Datei- oder Protokollzuordnungen und ruft sie aus der Registrierung ab.
IQueryAssociations::GetEnum Diese Methode ist nicht implementiert. (IQueryAssociations.GetEnum)
IQueryAssociations::GetKey Sucht nach einem Datei- oder Protokollzuordnungsschlüssel, und ruft er aus der Registrierung ab.
IQueryAssociations::GetString Sucht nach einer Datei- oder Protokollzuordnungszeichenfolge und ruft sie aus der Registrierung ab. (IQueryAssociations.GetString)
IQueryAssociations::Init Initialisiert die IQueryAssociations-Schnittstelle und legt den Stammschlüssel auf die entsprechende ProgID fest.

Hinweise

Wann sollte implementiert werden?

Diese Schnittstelle wird von der Shell oder von Namespaceerweiterungen verfügbar gemacht, um die Verarbeitung von Datei- und Protokollzuordnungen zu vereinfachen. Sie sollten diese Schnittstelle nicht implementieren.

Verwendungs-Gründe

Verwenden Sie diese Schnittstelle, wenn Sie Informationen aus der Registrierung benötigen, die sich auf Datei- oder Protokollzuordnungen beziehen. Beispielsweise können Sie diese Schnittstelle verwenden, um Informationen abzurufen, die einer Dateinamenerweiterung zugeordnet sind, z. B. die Befehlszeichenfolge eines ihrer Verben.

Ein vollständiger Registrierungspfad oder HKEY-Wert ist nicht erforderlich. Stattdessen können Sie Informationen basierend auf Kriterien wie der Dateinamenerweiterung oder dem Namen der ausführbaren Datei abrufen. Eine Erläuterung der Dateizuordnungen finden Sie unter Dateitypen.

Sie können auch den Namen einer Anwendung mithilfe dieser Schnittstelle abrufen. Verwenden Sie die IQueryAssociations::GetString-Methode. Legen Sie den str-Parameter auf ASSOCSTR_FRIENDLYAPPNAME fest.

Um diese Schnittstelle verwenden zu können, müssen Sie zuerst einen Zeiger darauf abrufen. In der Regel rufen Sie einen QueryInterface-Zeiger ab, indem Sie die IShellFolder::GetUIObjectOf-Methode eines Shell-Objekts aufrufen. Sie können auch einen Schnittstellenzeiger abrufen, indem Sie AssocCreate aufrufen ( clsid auf CLSID_QueryAssociations festlegen). Initialisieren Sie die -Schnittstelle mit IQueryAssociations::Init. Diese Methode legt den Stammschlüssel fest, der beim Aufrufen einer der verbleibenden drei Methoden zum Abrufen von Informationen aus der Registrierung verwendet wird. Sie sehen sich nur unterhalb des Stammschlüssels an. Sie müssen die Schnittstelle freigeben, wenn Sie sie nicht mehr benötigen.

Die IQueryAssociations-Schnittstelle ist nützlich, wenn Sie die Registrierung wiederholt nach Informationen abfragen müssen. Nachdem die Schnittstelle initialisiert wurde, ist der Mehraufwand beim Aufrufen der verschiedenen Methoden relativ gering. Es gibt auch mehrere verwandte Funktionen, die im Abschnitt Siehe auch aufgeführt sind, mit denen Sie dieselben Informationen mit einem einzelnen Funktionsaufruf aus der Registrierung abrufen können. Obwohl sie einfacher zu verwenden sind, verursachen sie bei jedem Aufruf den Mehraufwand beim Erstellen und Initialisieren von IQueryAssociations . Aus diesem Grund eignen sie sich am besten für den einmaligen Gebrauch.

Anforderungen

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

Weitere Informationen

AssocQueryKey

AssocQueryString

AssocQueryStringByKey