GetPackagesByPackageFamily-Funktion (appmodel.h)

Artikel
03/04/2024

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

Syntax

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

Parameter

[in] packageFamilyName

Typ: PCWSTR

Der Name der Paketfamilie.

[in, out] count

Typ: UINT32*

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

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

[out, optional] packageFullNames

Typ: PWSTR*

Ein Zeiger auf die Zeichenfolgen von vollständigen Paketnamen.

[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 dieser Nummer, um den Puffer aufzufüllen.

[out, optional] buffer

Typ: WCHAR*

Die Zeichenfolge für alle vollständigen Paketnamen.

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 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	appmodel.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

PackageNameAndPublisherIdFromFamilyName-Funktion (appmodel.h)

Freigeben über