Função GetPackageInfo2 (appmodel.h)

Artigo
02/26/2024

Obtém as informações do pacote especificado, com a opção de especificar o tipo de caminho de pasta a ser recuperado para o pacote.

Sintaxe

LONG GetPackageInfo2(
  PACKAGE_INFO_REFERENCE packageInfoReference,
  const UINT32           flags,
  PackagePathType        packagePathType,
  UINT32                 *bufferLength,
  BYTE                   *buffer,
  UINT32                 *count
);

Parâmetros

packageInfoReference

Tipo: PACKAGE_INFO_REFERENCE

Uma referência às informações do pacote.

flags

Tipo: const UINT32

As constantes de pacote que especificam como as informações do pacote são recuperadas.

packagePathType

Tipo: PackagePathType

Indica o tipo de caminho de pasta a ser recuperado para o pacote (a pasta de instalação original ou a pasta mutável).

bufferLength

Tipo: UINT32*

Na entrada, o tamanho do buffer, em bytes. Na saída, o tamanho das informações do pacote retornadas, em bytes.

buffer

Tipo: BYTE*

As informações do pacote, representadas como uma matriz de estruturas PACKAGE_INFO .

count

Tipo: UINT32*

O número de pacotes no buffer.

Retornar valor

Tipo: LONG

Se a função for bem-sucedida , ela retornará ERROR_SUCCESS. Caso contrário, a função retornará um código de erro. Os códigos de erro possíveis incluem o seguinte.

Código de retorno	Descrição
ERROR_INSUFFICIENT_BUFFER	O buffer não é grande o suficiente para manter os dados. O tamanho necessário é especificado por bufferLength.

Comentários

O parâmetro packagePathType é útil para aplicativos que usam a extensão windows.mutablePackageDirectories no manifesto do pacote. Essa extensão especifica uma pasta no caminho %ProgramFiles%\ModifiableWindowsApps em que o conteúdo da pasta de instalação do aplicativo é projetado para que os usuários possam modificar os arquivos de instalação. Atualmente, esse recurso está disponível apenas para determinados tipos de jogos de computador da área de trabalho que são publicados pela Microsoft e por nossos parceiros e permite que esses tipos de jogos ofereçam suporte a mods.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	appmodel.h
Biblioteca	Kernel32.lib
DLL	Kernel32.dll