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

另请参阅

IAppxManifestApplication