MddTryCreatePackageDependency, fonction (msixdynamicdependency.h)

Crée une référence au moment de l’installation pour une dépendance de package framework pour l’application actuelle, à l’aide du nom de famille de packages, de la version minimale et des critères supplémentaires spécifiés.

Syntaxe

HRESULT MddTryCreatePackageDependency(
  PSID                                       user,
  PCWSTR                                     packageFamilyName,
  PACKAGE_VERSION                            minVersion,
  MddPackageDependencyProcessorArchitectures packageDependencyProcessorArchitectures,
  MddPackageDependencyLifetimeKind           lifetimeKind,
  PCWSTR                                     lifetimeArtifact,
  MddCreatePackageDependencyOptions          options,
  PWSTR                                      *packageDependencyId
) noexcept;

Paramètres

user

Type : PSID

Étendue utilisateur de la dépendance de package. Si la valeur est NULL, le contexte utilisateur de l’appelant est utilisé. Doit être NULL si ScopeIsSystem est spécifié pour les options de paramètre.

packageFamilyName

Type : PCWSTR

Nom de la famille de packages du package d’infrastructure sur lequel prendre la dépendance.

minVersion

Type : PACKAGE_VERSION

Version minimale du package d’infrastructure sur laquelle prendre la dépendance.

packageDependencyProcessorArchitectures

Type : PackageDependencyProcessorArchitectures

Architectures du processeur de la dépendance de package.

lifetimeKind

Type : PackageDependencyLifetimeKind

Type d’artefact à utiliser pour définir la durée de vie de la dépendance de package. Pour plus d’informations, consultez les remarques.

lifetimeArtifact

Type : PCWSTR

Nom de l’artefact utilisé pour définir la durée de vie de la dépendance de package. Doit être NULL si le paramètre lifetimeKind est processus. Pour plus d’informations, consultez les remarques.

options

Type : CreatePackageDependencyOptions

Options à appliquer lors de la création de la dépendance de package.

packageDependencyId

Type : PWSTR*

ID de la nouvelle dépendance de package. Utilisez la fonction HeapAlloc pour allouer de la mémoire pour ce paramètre et utilisez heapFree pour libérer la mémoire.

Valeur de retour

Type : HRESULT

Si la fonction réussit, elle retourne ERROR_SUCCESS. Sinon, la fonction retourne un code d’erreur. Les codes d’erreur possibles sont les suivants.

Remarques

Dans le programme d’installation de votre application ou lors de la première exécution de votre application, appelez cette méthode pour spécifier un ensemble de critères pour un package d’infrastructure que vous souhaitez utiliser dans votre application. Cela informe le système d’exploitation que votre application a une dépendance sur un package d’infrastructure qui répond aux critères spécifiés. Si un ou plusieurs packages d’infrastructure sont installés qui répondent aux critères, Windows s’assure qu’au moins l’un de ces packages d’infrastructure reste installé jusqu’à ce que la référence au moment de l’installation soit supprimée. Pour plus d’informations, consultez Utiliser l’API de dépendance dynamique pour référencer des packages MSIX au moment de l’exécution.

Cette fonction échoue si les critères de dépendance spécifiés ne peuvent pas être résolus en un package spécifique. Cette vérification de résolution de package est ignorée si DoNotVerifyDependencyResolution est spécifiée pour les options de paramètre. Cela est utile pour les programmes d’installation s’exécutant en tant que contextes utilisateur autres que l’utilisateur cible (par exemple, les programmes d’installation s’exécutant en tant que LocalSystem).

Spécifications