Función FindPackagesByPackageFamily (appmodel.h)

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

Sintaxis

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

Parámetros

[in] packageFamilyName

Tipo: PCWSTR

Nombre de familia del paquete.

[in] packageFilters

Tipo: UINT32

Constantes de paquete que especifican cómo se recupera la información del paquete. Se admiten todas las constantes de paquete excepto PACKAGE_FILTER_ALL_LOADED .

[in, out] count

Tipo: UINT32*

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

En primer lugar, pasa NULL a packageFullNames para obtener el número de nombres completos del paquete que se encontraron. Use este número para asignar espacio de memoria para packageFullNames. Después, pase la dirección de este espacio de memoria para rellenar packageFullNames.

[out, optional] packageFullNames

Tipo: PWSTR*

Puntero al espacio de memoria que recibe las cadenas de nombres completos del paquete que se encontraron.

[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. A continuación, pase la dirección de este espacio de memoria para rellenar el búfer.

[out, optional] buffer

Tipo: WCHAR*

Puntero al espacio de memoria que recibe la cadena de caracteres para todos los nombres completos del paquete.

[out, optional] packageProperties

Tipo: UINT32*

Puntero al espacio de memoria que recibe las propiedades del paquete para todos los paquetes que se encontraron.

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.1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	appmodel.h
Library	Kernel32.lib
Archivo DLL	Kernel32.dll