Función FormatApplicationUserModelId (appmodel.h)

Artículo
08/22/2023

Construye un identificador de modelo de usuario de aplicación a partir del nombre de familia del paquete y el identificador de aplicación relativo del paquete (PRAID).

Sintaxis

LONG FormatApplicationUserModelId(
  [in]            PCWSTR packageFamilyName,
  [in]            PCWSTR packageRelativeApplicationId,
  [in, out]       UINT32 *applicationUserModelIdLength,
  [out, optional] PWSTR  applicationUserModelId
);

Parámetros

[in] packageFamilyName

Tipo: PCWSTR

Nombre de familia del paquete.

[in] packageRelativeApplicationId

Tipo: PCWSTR

Id. de aplicación relativa al paquete (PRAID).

[in, out] applicationUserModelIdLength

Tipo: UINT32*

Puntero a una variable que contiene el número de caracteres (WCHAR) en la cadena de identificador de modelo de usuario de la aplicación, que incluye el terminador null.

En primer lugar, pase NULL a applicationUserModelId para obtener el número de caracteres. Este número se usa para asignar espacio de memoria para applicationUserModelId. A continuación, pase la dirección de este espacio de memoria para rellenar applicationUserModelId.

[out, optional] applicationUserModelId

Tipo: PWSTR

Puntero al espacio de memoria que recibe la cadena de identificador del modelo de usuario de la aplicación, 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_INVALID_PARAMETER	El parámetro packageFamilyName o packageRelativeApplicationId no es válido.
ERROR_INSUFFICIENT_BUFFER	El búfer especificado por applicationUserModelId no es lo suficientemente grande como para contener los datos; el tamaño de búfer necesario, en WCHARs, se almacena en la variable a la que apunta applicationUserModelIdLength.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 R2 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	appmodel.h
Library	Kernel32.lib
Archivo DLL	Kernel32.dll