IAppxManifestApplication::GetStringValue 方法 (appxpackaging.h)
获取清单的应用程序元数据部分中元素或属性的字符串值。
语法
HRESULT GetStringValue(
[in] LPCWSTR name,
[out, retval] LPWSTR *value
);
参数
[in] name
类型: LPCWSTR
要从应用程序元数据获取的元素或属性值的名称。 支持的名称包括:
- AppListEntry
- BackgroundColor
- DefaultSize
- 说明
- DisplayName
- EntryPoint
- 可执行文件
- ForegroundText
- ID
- LockScreenLogo
- LockScreenNotification
- 徽标
- MinWidth
- ShortName
- SmallLogo
- Square150x150Logo
- Square30x30Logo
- Square310x310Logo
- Square44x44Logo
- Square70x70Logo
- Square71x71Logo
- StartPage
- Tall150x310Logo
- VisualGroup
- WideLogo
- Wide310x150Logo
请参阅 架构 ,确定从清单中读取这些值的位置。
[out, retval] value
类型: LPWSTR*
请求的元素或特性的值。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
如果 name 参数不是清单中某个元素或属性的受支持名称,则此方法返回 E_INVALIDARG。 如果 支持 name 参数,但在清单中找不到元素或属性,则此方法返回 S_OK 并且 value 参数的返回值为 NULL。
调用方必须使用 CoTaskMemFree 函数释放为值分配的内存。
示例
有关示例,请参阅 快速入门:读取应用包清单信息。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 8 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | Windows |
标头 | appxpackaging.h |