Compartilhar via

Função GetPackagePathByFullName2 (appmodel.h)

  • Artigo

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

Sintaxe

LONG GetPackagePathByFullName2(
  PCWSTR          packageFullName,
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Parâmetros

packageFullName

Tipo: PCWSTR

O nome completo do pacote.

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

pathLength

Tipo: UINT32*

Um ponteiro para uma variável que contém o número de caracteres (WCHARs) na cadeia de caracteres de caminho do pacote, que inclui o terminador nulo.

Primeiro, você passa NULL para o caminho para obter o número de caracteres. Você usa esse número para alocar espaço de memória para o caminho. Em seguida, você passa o endereço desse espaço de memória para preencher o caminho.

path

Tipo: PWSTR

Um ponteiro para o espaço de memória que recebe a cadeia de caracteres de caminho do pacote, que inclui o terminador nulo.

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 especificado pelo caminho não é grande o suficiente para manter os dados. O tamanho necessário é especificado por pathLength.

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 KernelBase.dll

Confira também

GetPackagePathByFullName