Функция MddTryCreatePackageDependency (msixdynamicdependency.h)

Создает ссылку во время установки для зависимости пакета платформы для текущего приложения, используя указанное имя семейства пакетов, минимальную версию и дополнительные условия.

Синтаксис

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

Параметры

user

Тип: PSID

Пользователь область зависимости пакета. Если значение РАВНО NULL, используется контекст пользователя вызывающего абонента. Значение должно иметь значение NULL, если для параметра optionsзадана система ScopeIsSystem.

packageFamilyName

Тип: PCWSTR

Имя семейства пакетов пакета платформы, от которого требуется получить зависимость.

minVersion

Тип: PACKAGE_VERSION

Минимальная версия пакета платформы, от которой требуется получить зависимость.

packageDependencyProcessorArchitectures

Тип: PackageDependencyProcessorArchitectures

Архитектуры процессора зависимости пакета.

lifetimeKind

Тип: PackageDependencyLifetimeKind

Тип артефакта, используемый для определения времени существования зависимости пакета. Дополнительные сведения см. в примечаниях.

lifetimeArtifact

Тип: PCWSTR

Имя артефакта, используемого для определения времени существования зависимости пакета. Значение должно иметь значение NULL, если параметр lifetimeKind имеет значение Process. Дополнительные сведения см. в примечаниях.

options

Тип: CreatePackageDependencyOptions

Параметры, применяемые при создании зависимости пакета.

packageDependencyId

Тип: PWSTR*

Идентификатор новой зависимости пакета. Используйте функцию HeapAlloc , чтобы выделить память для этого параметра, и heapFree , чтобы освободить память.

Возвращаемое значение

Тип: HRESULT

Если функция завершается успешно, она возвращает ERROR_SUCCESS. В противном случае функция возвращает код ошибки. Возможные коды ошибок включают следующие.

Код возврата	Описание
E_INVALIDARG	Параметр packageDependencyId на входных данных имеет значение NULL.

Комментарии

В установщике приложения или во время первого запуска приложения вызовите этот метод, чтобы указать набор критериев для пакета платформы, который вы хотите использовать в приложении. Это информирует операционную систему о том, что приложение зависит от пакета платформы, отвечающего указанным критериям. Если установлены один или несколько пакетов платформы, которые отвечают критериям, Windows гарантирует, что по крайней мере один из этих пакетов будет оставаться установленным до удаления ссылки времени установки. Дополнительные сведения см. в статье Использование API динамических зависимостей для ссылки на пакеты MSIX во время выполнения.

Эта функция завершается ошибкой, если указанные критерии зависимостей не могут быть разрешены в конкретный пакет. Это разрешение пакета проверка пропускается, если для параметра options задано значение DoNotVerifyDependencyResolution. Это полезно для установщиков, работающих в качестве контекстов пользователей, отличных от целевого пользователя (например, установщиков, работающих от имени LocalSystem).

Требования

Требование	Значение
Минимальная версия клиента	Windows 10, версия 1809 (с Windows App SDK 1.0 или более поздней версии)
Верхняя часть	msixdynamicdependency.h