Función FormatApplicationUserModelId (appmodel.h)
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 |
---|---|
|
El parámetro packageFamilyName o packageRelativeApplicationId no es válido. |
|
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 |