IQueryAssociations ::Init, méthode (shlwapi.h)

Article
08/26/2023

Initialise l’interface IQueryAssociations et définit la clé racine sur le ProgID approprié.

Syntaxe

HRESULT Init(
  [in]           ASSOCF  flags,
  [in, optional] LPCWSTR pszAssoc,
  [in, optional] HKEY    hkProgid,
  [in, optional] HWND    hwnd
);

Paramètres

[in] flags

Type : ASSOCF

Indicateur qui spécifie la façon dont la recherche doit être initialisée. Il est généralement défini sur zéro, mais il peut également prendre l’une des valeurs ASSOCF suivantes.

[in, optional] pszAssoc

Type : LPCWSTR

Chaîne Unicode utilisée pour déterminer la clé racine. Si une valeur est spécifiée pour hkProgid, définissez ce paramètre sur NULL. Vous pouvez utiliser quatre types de chaînes :

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, optional] hkProgid

Type : HKEY

Valeur HKEY de la sous-clé utilisée comme clé racine. La recherche se présente uniquement en dessous de cette clé. Si une valeur est spécifiée pour pwszAssoc, définissez ce paramètre sur NULL.

[in, optional] hwnd

Type : HWND

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode initialise l’interface et est également appelée chaque fois que vous devez spécifier une nouvelle clé racine. Vous pouvez utiliser pwszAssoc pour spécifier une chaîne, telle qu’une extension de nom de fichier ou son ProgID associé, qui identifie la clé racine. Vous pouvez également spécifier la valeur HKEY de la clé racine. Init utilisera ensuite ces informations pour localiser la clé racine dans le Registre. Les appels suivants aux autres méthodes IQueryAssociations l’utilisent comme point de départ et recherchent les informations dans les sous-clés de la clé racine.

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	Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

IQueryAssociations

Partager via