Funzione FindPackagesByPackageFamily (appmodel.h)

Trova i pacchetti con il nome della famiglia specificato per l'utente corrente.

Sintassi

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
);

Parametri

[in] packageFamilyName

Tipo: PCWSTR

Nome della famiglia di pacchetti.

[in] packageFilters

Tipo: UINT32

Costanti del pacchetto che specificano la modalità di recupero delle informazioni sul pacchetto. Sono supportate tutte le costanti del pacchetto tranne PACKAGE_FILTER_ALL_LOADED .

[in, out] count

Tipo: UINT32*

Puntatore a una variabile che contiene il numero di nomi completi del pacchetto trovati.

Prima di tutto si passa NULL a packageFullNames per ottenere il numero di nomi completi del pacchetto trovati. Questo numero viene usato per allocare spazio di memoria per packageFullNames. Passare quindi l'indirizzo di questo spazio di memoria per riempire packageFullNames.

[out, optional] packageFullNames

Tipo: PWSTR*

Puntatore allo spazio di memoria che riceve le stringhe dei nomi completi del pacchetto trovati.

[in, out] bufferLength

Tipo: UINT32*

Puntatore a una variabile che contiene il numero di caratteri nella stringa dei nomi completi del pacchetto.

Prima di tutto si passa NULL al buffer per ottenere il numero di caratteri. Questo numero viene usato per allocare spazio di memoria per il buffer. Passare quindi l'indirizzo di questo spazio di memoria per riempire il buffer.

[out, optional] buffer

Tipo: WCHAR*

Puntatore allo spazio di memoria che riceve la stringa di caratteri per tutti i nomi completi del pacchetto.

[out, optional] packageProperties

Tipo: UINT32*

Puntatore allo spazio di memoria che riceve le proprietà del pacchetto per tutti i pacchetti trovati.

Valore restituito

Tipo: LONG

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS. In caso contrario, la funzione restituisce un codice di errore. I codici di errore possibili includono quanto segue.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Uno o più buffer non sono sufficientemente grandi da contenere i dati. La dimensione richiesta viene specificata dal conteggio o dal buffer.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [solo app desktop]
Server minimo supportato	Windows Server 2012 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	appmodel.h
Libreria	Kernel32.lib
DLL	Kernel32.dll