Compartilhar via


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

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 do 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.

Retornar valor

Tipo: HRESULT

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

Comentários

Se o parâmetro name não for um nome com suporte de um elemento ou atributo no manifesto, esse método retornará E_INVALIDARG. Se houver suporte para o parâmetro name , mas o elemento ou atributo não for encontrado no manifesto, esse método retornará S_OK e o valor retornado do parâmetro value 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
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho appxpackaging.h

Confira também

IAppxManifestApplication