Función ParseApplicationUserModelId (appmodel.h)

Deconstruye un identificador de modelo de usuario de aplicación de a su nombre de familia de paquete y id. de aplicación relativa 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 (WCHARs) 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. A continuación, 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 (WCHARs) 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. A continuación, 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 códigos de error posibles 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

Requisito	Valor
cliente mínimo admitido	Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	appmodel.h
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll