Função GetPackagePathByFullName2 (appmodel.h)

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.

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

Confira também

GetPackagePathByFullName