Função GetCurrentPackagePath2 (appmodel.h)

Artigo
02/23/2024

Obtém o caminho 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 GetCurrentPackagePath2(
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Parâmetros

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*

Na entrada, o tamanho do buffer de caminho , em caracteres. Na saída, o tamanho do caminho do pacote retornado, em caracteres, incluindo o terminador nulo.

path

Tipo: PWSTR

O caminho do pacote.

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

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