IApplicationAssociationRegistration ::QueryCurrentDefault, méthode (shobjidl_core.h)

Article
03/04/2024

Détermine l’application par défaut pour un type d’association donné. Il s’agit de l’application par défaut lancée par ShellExecute pour ce type.

Syntaxe

HRESULT QueryCurrentDefault(
  [in]  LPCWSTR          pszQuery,
  [in]  ASSOCIATIONTYPE  atQueryType,
  [in]  ASSOCIATIONLEVEL alQueryLevel,
  [out] LPWSTR           *ppszAssociation
);

Paramètres

[in] pszQuery

Type : LPCWSTR

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient l’extension ou le protocole de nom de fichier, tel que .mp3 ou http.

[in] atQueryType

Type : ASSOCIATIONTYPE

Une des valeurs d’énumération ASSOCIATIONTYPE qui spécifie le type d’association, par exemple extension ou type MIME.

[in] alQueryLevel

Type : ASSOCIATIONLEVEL

Une des valeurs d’énumération ASSOCIATIONLEVEL qui spécifie le niveau d’association, par exemple par utilisateur ou par ordinateur. Il s’agit généralement AL_EFFECTIVE.

[out] ppszAssociation

Type : LPWSTR*

Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers le ProgID qui identifie l’association par défaut actuelle.

Note Il incombe à l’application appelante de libérer la chaîne via CoTaskMemFree.

Valeur retournée

Type : HRESULT

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

Remarques

La chaîne produite est généralement un ProgID correspondant à l’un des ProgID associés à une application inscrite, mais il existe quelques exceptions : si la chaîne retournée est un protocole par défaut de machine, il s’agit d’une chaîne héritée indiquant une ligne de commande à un gestionnaire de .exe au lieu d’un ProgID. De même, si vous retournez un type MIME par défaut de machine, il retourne une chaîne d’identificateur de classe héritée (CLSID) au lieu d’un ProgID.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)

Voir aussi

Programmes par défaut

IApplicationAssociationRegistration

Partager via