FindPackagesByPackageFamily-Funktion (appmodel.h)

Sucht die Pakete mit dem angegebenen Familiennamen für den aktuellen Benutzer.

Syntax

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

Parameter

[in] packageFamilyName

Typ: PCWSTR

Der Name der Paketfamilie.

[in] packageFilters

Typ: UINT32

Die Paketkonstanten , die angeben, wie Paketinformationen abgerufen werden. Alle Paketkonstanten mit Ausnahme von PACKAGE_FILTER_ALL_LOADED werden unterstützt.

[in, out] count

Typ: UINT32*

Ein Zeiger auf eine Variable, die die Anzahl der gefundenen vollständigen Paketnamen enthält.

Zuerst übergeben Sie NULL an packageFullNames , um die Anzahl der gefundenen vollständigen Paketnamen abzurufen. Sie verwenden diese Nummer, um Speicherplatz für packageFullNames zuzuweisen. Anschließend übergeben Sie die Adresse dieses Speicherplatzes, um packageFullNames zu füllen.

[out, optional] packageFullNames

Typ: PWSTR*

Ein Zeiger auf den Speicherplatz, der die Zeichenfolgen der gefundenen vollständigen Paketnamen empfängt.

[in, out] bufferLength

Typ: UINT32*

Ein Zeiger auf eine Variable, die die Anzahl der Zeichen in der Zeichenfolge der vollständigen Paketnamen enthält.

Zuerst übergeben Sie NULL an den Puffer , um die Anzahl der Zeichen abzurufen. Sie verwenden diese Nummer, um Speicherplatz für den Puffer zuzuweisen. Anschließend übergeben Sie die Adresse dieses Speicherplatzes, um den Puffer aufzufüllen.

[out, optional] buffer

Typ: WCHAR*

Ein Zeiger auf den Speicherplatz, der die Zeichenfolge für alle vollständigen Paketnamen empfängt.

[out, optional] packageProperties

Typ: UINT32*

Ein Zeiger auf den Speicherplatz, der die Paketeigenschaften für alle gefundenen Pakete empfängt.

Rückgabewert

Typ: LONG

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück. Andernfalls gibt die Funktion einen Fehlercode zurück. Folgende Fehlercodes sind möglich.

Rückgabecode	Beschreibung
ERROR_INSUFFICIENT_BUFFER	Mindestens ein Puffer ist nicht groß genug, um die Daten aufzunehmen. Die erforderliche Größe wird entweder durch Anzahl oder Puffer angegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	appmodel.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll