Compartir a través de

Función GetStagedPackagePathByFullName2 (appmodel.h)

  • Artículo

Obtiene la ruta de acceso del paquete preconfigurado 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 GetStagedPackagePathByFullName2(
  PCWSTR          packageFullName,
  PackagePathType packagePathType,
  UINT32          *pathLength,
  PWSTR           path
);

Parámetros

packageFullName

Tipo: PCWSTR

Nombre completo del paquete preconfigurado.

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*

Puntero a una variable que contiene el número de caracteres (WCHAR) en la cadena de ruta de acceso del paquete, que incluye el terminador null.

En primer lugar, pase NULL a la ruta de acceso para obtener el número de caracteres. Use este número para asignar espacio de memoria para la ruta de acceso. A continuación, pase la dirección de este espacio de memoria para rellenar la ruta de acceso.

path

Tipo: PWSTR

Puntero al espacio de memoria que recibe la cadena de ruta de acceso del paquete, que incluye el terminador null.

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 especificado por la ruta de acceso 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 %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

Vea también

GetStagedPackagePathByFullName