AssocQueryKeyA-Funktion (shlwapi.h)
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) |