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

Artigo
03/05/2025

Obtém o valor da cadeia de caracteres de um elemento ou atributo na seção de metadados do aplicativo do manifesto.

Sintaxe

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

Parâmetros

[in] name

Tipo: LPCWSTR

O nome do elemento ou valor de atributo a ser obtido dos metadados do aplicativo. Os nomes com suporte incluem:

AppListEntry
BackgroundColor
DefaultSize
Descrição
DisplayName
EntryPoint
Executável
ForegroundText
ID
LockScreenLogo
LockScreenNotification
Logotipo
MinWidth
ShortName
SmallLogo
Square150x150Logo
Square30x30Logo
Square310x310Logo
Square44x44Logo
Square70x70Logo
Square71x71Logo
StartPage
Tall150x310Logo
VisualGroup
WideLogo
Wide310x150Logo

Consulte o esquema para determinar de onde esses valores estão sendo lidos no manifesto.

[out, retval] value

Tipo: * LPWSTR

O valor do elemento ou atributo solicitado.

Valor de retorno

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Observações

Se o nome parâmetro não for um nome compatível de um elemento ou atributo no manifesto, esse método retornará E_INVALIDARG. Se o nome parâmetro tiver suporte, mas o elemento ou atributo não for encontrado no manifesto, esse método retornará S_OK e o valor retornado do parâmetro de valor será NULL.

O chamador deve liberar a memória alocada para valor usando a função CoTaskMemFree.

Exemplos

Para obter um exemplo, consulte Início Rápido: Ler informações de manifesto do pacote do aplicativo.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2012 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	appxpackaging.h

Consulte também

IAppxManifestApplication

Compartilhar via