IAppxManifestApplication::GetStringValue-Methode (appxpackaging.h)
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 |