Méthode IAppxManifestApplication ::GetStringValue (appxpackaging.h)

Article
02/26/2024

Obtient la valeur de chaîne d’un élément ou d’un attribut dans la section de métadonnées d’application du manifeste.

Syntaxe

HRESULT GetStringValue(
  [in]          LPCWSTR name,
  [out, retval] LPWSTR  *value
);

Paramètres

[in] name

Type : LPCWSTR

Nom de l’élément ou de la valeur d’attribut à obtenir à partir des métadonnées de l’application. Les noms pris en charge sont les suivants :

AppListEntry
BackgroundColor
DefaultSize
Description
DisplayName
EntryPoint
Exécutable
ForegroundText
id
LockScreenLogo
LockScreenNotification
Logo
Minwidth
NomCourt
SmallLogo
Square150x150Logo
Square30x30Logo
Square310x310Logo
Square44x44Logo
Square70x70Logo
Square71x71Logo
StartPage
Tall150x310Logo
VisualGroup
WideLogo
Wide310x150Logo

Reportez-vous au schéma pour déterminer où ces valeurs sont lues dans le manifeste.

[out, retval] value

Type : LPWSTR*

Valeur de l’élément ou de l’attribut demandé.

Valeur retournée

Type : HRESULT

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

Remarques

Si le paramètre name n’est pas un nom pris en charge d’un élément ou d’un attribut dans le manifeste, cette méthode retourne E_INVALIDARG. Si le paramètre name est pris en charge, mais que l’élément ou l’attribut est introuvable dans le manifeste, cette méthode retourne S_OK et la valeur de retour du paramètre value est NULL.

L’appelant doit libérer la mémoire allouée pour la valeur à l’aide de la fonction CoTaskMemFree .

Exemples

Pour obtenir un exemple, consultez Démarrage rapide : Lire les informations du manifeste du package d’application.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	appxpackaging.h

Voir aussi

IAppxManifestApplication

Partager via