Condividi tramite


Funzione GetPackagesByPackageFamily (appmodel.h)

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

Sintassi

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

Parametri

[in] packageFamilyName

Tipo: PCWSTR

Nome della famiglia di pacchetti.

[in, out] count

Tipo: UINT32*

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

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

[out, optional] packageFullNames

Tipo: PWSTR*

Puntatore alle stringhe dei nomi completi del pacchetto.

[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 numero al buffer di riempimento.

[out, optional] buffer

Tipo: WCHAR*

Stringa di caratteri per tutti i nomi completi del pacchetto.

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 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione appmodel.h
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

PackageNameAndPublisherIdFromFamilyName