Función GetPackageInfo2 (appmodel.h)

Artículo
02/23/2024

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

Sintaxis

LONG GetPackageInfo2(
  PACKAGE_INFO_REFERENCE packageInfoReference,
  const UINT32           flags,
  PackagePathType        packagePathType,
  UINT32                 *bufferLength,
  BYTE                   *buffer,
  UINT32                 *count
);

Parámetros

packageInfoReference

Tipo: PACKAGE_INFO_REFERENCE

Referencia a la información del paquete.

flags

Tipo: const UINT32

Constantes de paquete que especifican cómo se recupera la información del paquete.

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

bufferLength

Tipo: UINT32*

En la entrada, el tamaño del búfer, en bytes. En la salida, el tamaño de la información del paquete devuelta, en bytes.

buffer

Tipo: BYTE*

La información del paquete, representada como una matriz de estructuras de PACKAGE_INFO .

count

Tipo: UINT32*

Número de paquetes del búfer.

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
ERROR_INSUFFICIENT_BUFFER	El búfer no es lo suficientemente grande como para contener los datos. BufferLength especifica el tamaño necesario.

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