AssocQueryKeyA, fonction (shlwapi.h)

Article
08/26/2023

Recherche et récupère une clé liée à un fichier ou une association de protocole à partir du Registre.

Syntaxe

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

Paramètres

[in] flags

Type : ASSOCF

Indicateurs qui peuvent être utilisés pour contrôler la recherche. Il peut s’agir de n’importe quelle combinaison de valeurs ASSOCF , sauf qu’une seule valeur ASSOCF_INIT peut être incluse.

[in] key

Type : ASSOCKEY

Valeur ASSOCKEY qui spécifie le type de clé à retourner.

[in] pszAssoc

Type : LPCTSTR

Pointeur vers une chaîne terminée par null utilisée pour déterminer la clé racine. Quatre types de chaînes peuvent être utilisés.

Extension de nom de fichier

Extension de nom de fichier, telle que .txt.

CLSID

GUID CLSID au format standard « {GUID} ».

ProgID

ProgID d’une application, comme Word. Document.8.

Nom de l’exécutable

Nom du fichier .exe d’une application. L’indicateur ASSOCF_OPEN_BYEXENAME doit être défini dans des indicateurs.

[in] pszExtra

Type : LPCTSTR

Pointeur vers une chaîne null facultative avec des informations supplémentaires sur l’emplacement de la chaîne. Il est normalement défini sur un verbe Shell tel que open. Définissez ce paramètre sur NULL s’il n’est pas utilisé.

[out] phkeyOut

Type : HKEY*

Pointeur vers la valeur HKEY de la clé.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur COM dans le cas contraire.

Remarques

Cette fonction est un wrapper pour l’interface IQueryAssociations . Il est destiné à simplifier le processus d’utilisation de l’interface. Pour plus d’informations sur le fonctionnement des fonctions d’association de fichiers et de protocole, consultez IQueryAssociations.

Notes

L’en-tête shlwapi.h définit AssocQueryKey comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
Bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Partager via