Función ParseApplicationUserModelId (appmodel.h)

Artículo
03/14/2023

Deconstruye un identificador de modelo de usuario de aplicación para su nombre de familia de paquete y el identificador de aplicación relativo al paquete (PRAID).

Sintaxis

LONG ParseApplicationUserModelId(
  [in]            PCWSTR applicationUserModelId,
  [in, out]       UINT32 *packageFamilyNameLength,
  [out, optional] PWSTR  packageFamilyName,
  [in, out]       UINT32 *packageRelativeApplicationIdLength,
  [out, optional] PWSTR  packageRelativeApplicationId
);

Parámetros

[in] applicationUserModelId

Tipo: PCWSTR

Identificador del modelo de usuario de la aplicación.

[in, out] packageFamilyNameLength

Tipo: UINT32*

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

En primer lugar, pase NULL a packageFamilyName para obtener el número de caracteres. Use este número para asignar espacio de memoria para packageFamilyName. Después, pase la dirección de este espacio de memoria para rellenar packageFamilyName.

[out, optional] packageFamilyName

Tipo: PWSTR

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

[in, out] packageRelativeApplicationIdLength

Tipo: UINT32*

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

En primer lugar, pase NULL a packageRelativeApplicationId para obtener el número de caracteres. Use este número para asignar espacio de memoria para packageRelativeApplicationId. Después, pase la dirección de este espacio de memoria para rellenar packageRelativeApplicationId.

[out, optional] packageRelativeApplicationId

Tipo: PWSTR

Puntero al espacio de memoria que recibe la cadena de id. de aplicación relativa al paquete (PRAID), 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 applicationUserModelId no es válido.
ERROR_INSUFFICIENT_BUFFER	El búfer especificado por packageFamilyName o packageRelativeApplicationId 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 packageFamilyNameLength o packageRelativeApplicationIdLength.

Requisitos


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