AssocQueryKeyA-Funktion (shlwapi.h)

  • Artikel

Sucht nach einem Schlüssel, der sich auf eine Datei- oder Protokollzuordnung bezieht, und ruft diesen aus der Registrierung ab.

Syntax

LWSTDAPI AssocQueryKeyA(
  [in]  ASSOCF   flags,
  [in]  ASSOCKEY key,
  [in]  LPCSTR   pszAssoc,
  [in]  LPCSTR   pszExtra,
  [out] HKEY     *phkeyOut
);

Parameter

[in] flags

Typ: ASSOCF

Die Flags, die zum Steuern der Suche verwendet werden können. Es kann sich um eine beliebige Kombination von ASSOCF-Werten handeln, mit der Ausnahme, dass nur ein ASSOCF_INIT Wert eingeschlossen werden kann.

[in] key

Typ: ASSOCKEY

Der ASSOCKEY-Wert , der den Typ des Schlüssels angibt, der zurückgegeben werden soll.

[in] pszAssoc

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die zum Bestimmen des Stammschlüssels verwendet wird. Es können vier Zeichenfolgentypen verwendet werden.

Dateinamenerweiterung

Eine Dateinamenerweiterung, z. B. .txt.

CLSID

Eine CLSID-GUID im Standardformat "{GUID}".

ProgID

ProgID einer Anwendung, z. B. Word. Document.8.

Name der ausführbaren Datei

Der Name der .exe-Datei einer Anwendung. Das ASSOCF_OPEN_BYEXENAME-Flag muss in Flags festgelegt werden.

[in] pszExtra

Typ: LPCTSTR

Ein Zeiger auf eine optionale NULL-endende Zeichenfolge mit zusätzlichen Informationen zum Speicherort der Zeichenfolge. Es wird normalerweise auf ein Shell-Verb festgelegt, z. B. open. Legen Sie diesen Parameter auf NULL fest, wenn er nicht verwendet wird.

[out] phkeyOut

Typ: HKEY*

Ein Zeiger auf den HKEY-Wert des Schlüssels.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Fehlerwert zurück.

Hinweise

Diese Funktion ist ein Wrapper für die IQueryAssociations-Schnittstelle . Es soll den Prozess der Verwendung der -Schnittstelle vereinfachen. Weitere Informationen zur Funktionsweise der Datei- und Protokollzuordnungsfunktionen finden Sie unter IQueryAssociations.

Hinweis

Der shlwapi.h-Header definiert AssocQueryKey als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.0 oder höher)