Méthode IShellApp ::GetAppInfo (shappmgr.h)

Article
03/01/2024

Obtient des informations générales sur une application.

Syntaxe

HRESULT GetAppInfo(
  [out] PAPPINFODATA pai
);

Paramètres

[out] pai

Type : APPINFODATA*

Pointeur vers une structure APPINFODATA qui retourne les informations de l’application.

Valeur retournée

Type : HRESULT

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

Remarques

Note Ajouter/supprimer des programmes dans le Panneau de configuration définit les membres cbSize et dwMask de la structure APPINFODATA.

Votre implémentation doit valider cbSize en la comparant à la taille d’APPINFODATA. Si cbSize n’est pas égal à la taille d’APPINFODATA, cette méthode doit retourner une valeur d’erreur COM telle que E_FAIL.

Ajout/suppression de programmes dans le Panneau de configuration définit le membre dwMask de la structure APPINFODATA pour indiquer que vous devez retourner AIM_DISPLAYNAME et AIM_SUPPORTURL. Pour chaque valeur que vous retournez dans APPINFODATA, vous devez définir le bit correspondant dans dwMask. Tous les autres bits doivent être effacés.

Exemples

Voici un exemple d’utilisation des bits dwMask :

HRESULT CPubApp::GetAppInfo(APPINFODATA *pData)
{
    if (sizeof(APPINFODATA) != pData->cbSize)
        return E_FAIL;

    // First save off the mask of requested data items.

    const DWORD dwMask = pData->dwMask;

    // Zero-out the mask.  Bits will be set as items are obtained. 

    pData->dwMask = 0;

    // Call an internal function that obtains data and sets
    // bits in pData->dwMask for each item obtained.

    return get_app_info_data(pData, dwMask);

}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP, Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shappmgr.h
DLL	Shell32.dll

Voir aussi

APPINFODATA

IAppPublisher

IPublishedApp ::GetPublishedAppInfo

IShellApp

Partager via