Teilen über

AddPackageDependency2-Funktion (appmodel.h)

Fügt einen Laufzeitverweis für die zuvor erstellte Frameworkpaketabhängigkeit mithilfe der TryCreatePackageDependency--Methode mit den angegebenen Optionen hinzu. Nachdem diese Methode erfolgreich zurückgegeben wurde, kann Ihre App Typen aktivieren und Inhalte aus dem Frameworkpaket verwenden.

Syntax

HRESULT AddPackageDependency2(
  PCWSTR                       packageDependencyId,
  INT32                        rank,
  AddPackageDependencyOptions2 options,
  PACKAGEDEPENDENCY_CONTEXT    *packageDependencyContext,
  PWSTR                        *packageFullName
);

Parameter

packageDependencyId

Typ: PCWSTR-

Die ID der Paketabhängigkeit, die aufgelöst und dem Paketdiagramm des aufrufenden Prozesses hinzugefügt werden soll. Dieser Parameter muss mit einer Paketabhängigkeit übereinstimmen, die mithilfe der TryCreatePackageDependency--Funktion für den aufrufenden Benutzer oder das System (über die Option CreatePackageDependencyOptions_ScopeIsSystem) definiert wird, oder andernfalls wird ein Fehler zurückgegeben.

rank

Typ: INT32-

Der Rang, der zum Hinzufügen des aufgelösten Pakets zum Paketdiagramm des Aufrufers verwendet werden soll. Weitere Informationen finden Sie unter Anmerkungen.

options

Typ: AddPackageDependencyOptions2

Die Beim Hinzufügen der Paketabhängigkeit anzuwendenden Optionen.

packageDependencyContext

Typ: PACKAGEDEPENDENCY_CONTEXT*

Das Handle der hinzugefügten Paketabhängigkeit. Dieses Handle ist gültig, bis es an RemovePackageDependencyübergeben wird.

packageFullName

Typ: PCWSTR*

Wenn diese Methode zurückgegeben wird, enthält die Adresse eines Zeigers auf eine mit Null beendete Unicode-Zeichenfolge, die den vollständigen Namen des Pakets angibt, in das die Abhängigkeit aufgelöst wurde. Der Anrufer ist für das Freigeben dieser Ressource verantwortlich, sobald sie nicht mehr benötigt wird, indem HeapFree-aufgerufen wird.

Rückgabewert

Typ: HRESULT-

Wenn die Funktion erfolgreich verläuft, wird ERROR_SUCCESSzurückgegeben. Andernfalls gibt die Funktion einen Fehlercode zurück. Die möglichen Fehlercodes umfassen Folgendes.

Rückgabecode Beschreibung
E_INVALIDARG Der parameter packageDependencyId oder packageDependencyContext parameter ist NULL für die Eingabe.

Bemerkungen

Siehe Hinweise für AddPackageDependency.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 11, Version 23H2 (10.0; Build 22631)
Header- appmodel.h

Siehe auch