Função GetCurrentPackageInfo2 (appmodel.h)

Artigo
02/23/2024

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

Sintaxe

LONG GetCurrentPackageInfo2(
  const UINT32    flags,
  PackagePathType packagePathType,
  UINT32          *bufferLength,
  BYTE            *buffer,
  UINT32          *count
);

Parâmetros

flags

Tipo: const UINT32

As constantes de pacote que especificam como as informações do pacote são recuperadas. Há suporte para os sinalizadores PACKAGE_FILTER_ *.

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 da matriz de estruturas retornada, 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 estruturas 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
APPMODEL_ERROR_NO_PACKAGE	O processo não tem nenhum identificador de pacote.
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