PackageDependency.CreateForSystem Método

Definição

Namespace:

Microsoft.Windows.ApplicationModel.DynamicDependency

Cria uma referência de tempo de instalação para uma dependência de pacote de estrutura para o aplicativo atual, usando o nome da família de pacotes especificado e a versão mínima e as opções especificadas. Esse método cria uma dependência de pacote de estrutura acessível a todos os usuários, e esse método requer que o chamador tenha privilégios administrativos. Para criar uma dependência de pacote de estrutura acessível apenas ao usuário atual, use o método 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

Parâmetros

packageFamilyName

String

Platform::String

winrt::hstring

O nome da família de pacotes do pacote de estrutura no qual assumir a dependência.

minVersion

PackageVersion

A versão mínima do pacote de estrutura no qual assumir a dependência.

options

CreatePackageDependencyOptions

Define critérios adicionais para especificar o pacote de estrutura que você deseja usar em seu aplicativo.

Retornos

PackageDependency

O objeto que representa a dependência do pacote e fornece membros que você pode usar para gerenciar o tempo de vida da dependência.

Comentários

No instalador do aplicativo ou durante a primeira execução do aplicativo, chame esse método para especificar um conjunto de critérios para um pacote de estrutura que você deseja usar em seu aplicativo. Isso informa ao sistema operacional que o aplicativo tem uma dependência de um pacote de estrutura que atende aos critérios especificados. Se um ou mais pacotes de estrutura que atendem aos critérios estiverem instalados, o Windows garantirá que pelo menos um desses pacotes de estrutura permaneça instalado até que a referência em tempo de instalação seja excluída. Para obter mais informações, consulte Usar a API de dependência dinâmica para referenciar pacotes MSIX em tempo de execução.

Essa função falhará se os critérios de dependência especificados não puderem ser resolvidos para um pacote específico. Essa verificação de resolução de pacote pode ser ignorada usando VerifyDependencyResolution é especificada para o parâmetro options . Isso é útil para instaladores em execução como contextos de usuário diferentes do usuário de destino (por exemplo, instaladores em execução como LocalSystem).

Confira também

• Usar a API de dependência dinâmica para referenciar pacotes MSIX em tempo de execução