PackageDependency.CreateForSystem Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée une référence au moment de l’installation pour une dépendance de package d’infrastructure pour l’application actuelle, à l’aide du nom de famille de package et de la version minimale spécifiés, ainsi que des options spécifiées. Cette méthode crée une dépendance de package d’infrastructure accessible à tous les utilisateurs, et cette méthode nécessite que l’appelant dispose de privilèges administratifs. Pour créer une dépendance de package d’infrastructure accessible uniquement à l’utilisateur actuel, utilisez plutôt la méthode Create .
public:
static PackageDependency ^ CreateForSystem(Platform::String ^ packageFamilyName, PackageVersion minVersion, CreatePackageDependencyOptions ^ options);
static PackageDependency CreateForSystem(winrt::hstring const& packageFamilyName, PackageVersion const& minVersion, CreatePackageDependencyOptions const& options);
public static PackageDependency CreateForSystem(string packageFamilyName, PackageVersion minVersion, CreatePackageDependencyOptions options);
function createForSystem(packageFamilyName, minVersion, options)
Public Shared Function CreateForSystem (packageFamilyName As String, minVersion As PackageVersion, options As CreatePackageDependencyOptions) As PackageDependency
Paramètres
- packageFamilyName
-
String
Platform::String
winrt::hstring
Nom de la famille de package du package d’infrastructure sur lequel prendre la dépendance.
- minVersion
- PackageVersion
Version minimale du package d’infrastructure sur laquelle prendre la dépendance.
- options
- CreatePackageDependencyOptions
Définit des critères supplémentaires pour spécifier le package d’infrastructure que vous souhaitez utiliser dans votre application.
Retours
Objet qui représente la dépendance de package et fournit des membres que vous pouvez utiliser pour gérer la durée de vie de la dépendance.
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. Cet appel permet d’indiquer au système d’exploitation que votre application comporte une dépendance vis-à-vis d’un package d’infrastructure qui répond aux critères spécifiés. Si un ou plusieurs packages d’infrastructure répondant aux critères sont installés, Windows veille à ce qu’au moins un de ces packages reste installé jusqu’à la suppression de la référence au moment de l’installation. 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 peut être ignorée à l’aide de la solution VerifyDependencyResolution spécifiée pour le paramètre options . 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).