Función GetCurrentPackagePath2 (appmodel.h)

Artículo
03/14/2023

Obtiene la ruta de acceso del paquete para el proceso de llamada, con la opción de especificar el tipo de ruta de acceso de carpeta que se va a recuperar para el paquete.

Sintaxis

LONG GetCurrentPackagePath2(
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Parámetros

packagePathType

Tipo: PackagePathType

Indica el tipo de ruta de acceso de carpeta que se va a recuperar para el paquete (la carpeta de instalación original o la carpeta mutable).

pathLength

Tipo: UINT32*

En la entrada, el tamaño del búfer de ruta de acceso , en caracteres. En la salida, el tamaño de la ruta de acceso del paquete devuelta, en caracteres, incluido el terminador NULL.

path

Tipo: PWSTR

Ruta de acceso al paquete.

Valor devuelto

Tipo: LONG

Si la función se realiza correctamente, devuelve ERROR_SUCCESS. De lo contrario, la función devuelve un código de error. Los posibles códigos de error incluyen lo siguiente.

Código devuelto	Descripción
APPMODEL_ERROR_NO_PACKAGE	El proceso no tiene ninguna identidad de paquete.
ERROR_INSUFFICIENT_BUFFER	El búfer no es lo suficientemente grande como para contener los datos. El tamaño necesario se especifica mediante pathLength.

Comentarios

El parámetro packagePathType es útil para las aplicaciones que usan la extensión windows.mutablePackageDirectories en su manifiesto de paquete. Esta extensión especifica una carpeta en la ruta de acceso %ProgramFiles%\ModifiableWindowsApps donde se proyecta el contenido de la carpeta de instalación de la aplicación para que los usuarios puedan modificar los archivos de instalación. Esta característica solo está disponible actualmente para determinados tipos de juegos de pc de escritorio publicados por Microsoft y nuestros asociados, y permite que estos tipos de juegos admitan mods.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	appmodel.h
Library	Kernel32.lib
Archivo DLL	Kernel32.dll