Función GetCurrentPackageInfo2 (appmodel.h)

Artículo
02/26/2024

Obtiene la información 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 GetCurrentPackageInfo2(
  const UINT32    flags,
  PackagePathType packagePathType,
  UINT32          *bufferLength,
  BYTE            *buffer,
  UINT32          *count
);

Parámetros

flags

Tipo: const UINT32

Constantes de paquete que especifican cómo se recupera la información del paquete. Se admiten las marcas PACKAGE_FILTER_* .

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 matriz de estructuras devuelta, en bytes.

buffer

Tipo: BYTE*

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

count

Tipo: UINT32*

Número de estructuras 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
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. 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 %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