Funzione GetPackagesByPackageFamily (appmodel.h)

Articolo
02/28/2024

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

Share via