IAppxManifestApplication::GetStringValue-Methode (appxpackaging.h)

Artikel
08/22/2023

Ruft den Zeichenfolgenwert eines Elements oder Attributs im Anwendungsmetadatenabschnitt des Manifests ab.

Syntax

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

Parameter

[in] name

Typ: LPCWSTR

Der Name des Elements oder Attributwerts, der aus den Anwendungsmetadaten abgerufen werden soll. Zu den unterstützten Namen gehören:

AppListEntry
BackgroundColor
DefaultSize
BESCHREIBUNG
DisplayName
EntryPoint
Ausführbare Datei
ForegroundText
ID
LockScreenLogo
LockScreenNotification
Logo
Minwidth
ShortName
SmallLogo
Square150x150Logo
Square30x30Logo
Square310x310Logo
Square44x44Logo
Square70x70Logo
Square71x71Logo
StartPage
Tall150x310Logo
VisualGroup
WideLogo
Wide310x150Logo

Verwenden Sie das Schema , um zu bestimmen, wo diese Werte im Manifest gelesen werden.

[out, retval] value

Typ: LPWSTR*

Der Wert des angeforderten Elements oder Attributs.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn der name-Parameter kein unterstützter Name eines Elements oder Attributs im Manifest ist, gibt diese Methode E_INVALIDARG zurück. Wenn der name-Parameter unterstützt wird, aber das Element oder Attribut nicht im Manifest gefunden wird, gibt diese Methode S_OK zurück, und der Rückgabewert des value-Parameters ist NULL.

Der Aufrufer muss den für den Wert zugewiesenen Arbeitsspeicher mithilfe der CoTaskMemFree-Funktion freigeben.

Beispiele

Ein Beispiel finden Sie unter Schnellstart: Lesen von App-Paketmanifestinformationen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	appxpackaging.h

Weitere Informationen

IAppxManifestApplication

Share via