Compartir a través de

Función ParseApplicationUserModelId (appmodel.h)

  • Artículo

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