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.

Requisiti