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 |