Función GetPackagesByPackageFamily (appmodel.h)

  • Artículo

Obtiene los paquetes con el nombre de familia especificado para el usuario actual.

Sintaxis

LONG GetPackagesByPackageFamily(
  [in]            PCWSTR packageFamilyName,
  [in, out]       UINT32 *count,
  [out, optional] PWSTR  *packageFullNames,
  [in, out]       UINT32 *bufferLength,
  [out, optional] WCHAR  *buffer
);

Parámetros

[in] packageFamilyName

Tipo: PCWSTR

Nombre de familia del paquete.

[in, out] count

Tipo: UINT32*

Puntero a una variable que contiene el número de nombres completos del paquete.

En primer lugar, pase NULL a packageFullNames para obtener el número de nombres completos del paquete. Use este número para asignar espacio de memoria para packageFullNames. A continuación, pase la dirección de este número para rellenar packageFullNames.

[out, optional] packageFullNames

Tipo: PWSTR*

Puntero a las cadenas de nombres completos del paquete.

[in, out] bufferLength

Tipo: UINT32*

Puntero a una variable que contiene el número de caracteres de la cadena de nombres completos del paquete.

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

[out, optional] buffer

Tipo: WCHAR*

Cadena de caracteres para todos los nombres completos del paquete.

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_INSUFFICIENT_BUFFER
 Uno o varios búferes no son lo suficientemente grandes como para contener los datos. El tamaño necesario se especifica mediante recuento o búfer.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado appmodel.h
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

PackageNameAndPublisherIdFromFamilyName