Função GetStagedPackagePathByFullName2 (appmodel.h)

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

Sintaxe

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

Parâmetros

packageFullName

Tipo: PCWSTR

O nome completo do pacote preparado.

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 do 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 do 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. No momento, esse recurso está disponível apenas para determinados tipos de jogos de computador desktop publicados pela Microsoft e por nossos parceiros e permite que esses tipos de jogos ofereçam suporte a mods.

Requisitos

Confira também

GetStagedPackagePathByFullName