Функция AddPackageDependency2 (appmodel.h)
Добавляет ссылку во время выполнения для зависимости пакета платформы, созданной ранее с помощью метода TryCreatePackageDependency с указанными параметрами. После успешного возвращения этого метода приложение может активировать типы и использовать содержимое из пакета платформы.
Синтаксис
HRESULT AddPackageDependency2(
PCWSTR packageDependencyId,
INT32 rank,
AddPackageDependencyOptions2 options,
PACKAGEDEPENDENCY_CONTEXT *packageDependencyContext,
PWSTR *packageFullName
);
Параметры
packageDependencyId
Тип: PCWSTR
Идентификатор зависимости пакета, которую необходимо устранить и добавить в граф пакета вызывающего процесса. Этот параметр должен соответствовать зависимости пакета, определенной с помощью функции TryCreatePackageDepend ency для вызывающего пользователя или системы (через параметр CreatePackageDependencyOptions_ScopeIsSystem), или возвращается ошибка.
rank
Тип: INT32
Ранг, используемый для добавления разрешенного пакета в граф пакета вызывающего абонента. Дополнительные сведения см. в примечаниях.
options
Тип: AddPackageDependencyOptions2
Параметры, применяемые при добавлении зависимости пакета.
packageDependencyContext
Тип: PACKAGEDEPENDENCY_CONTEXT*
Дескриптор добавленной зависимости пакета. Этот дескриптор действителен, пока он не будет передан в RemovePackageDependency.
packageFullName
Тип: PCWSTR*
При возврате этого метода содержит адрес указателя на строку Юникода, завершающую значение NULL, которая указывает полное имя пакета, к которому была разрешена зависимость. Вызывающий объект отвечает за освобождение этого ресурса после того, как он больше не нужен, вызвав HeapFree.
Возвращаемое значение
Тип: HRESULT
Если функция завершается успешно, она возвращает ERROR_SUCCESS. В противном случае функция возвращает код ошибки. Возможные коды ошибок включают следующие.
Возвращаемый код | Описание |
---|---|
E_INVALIDARG | Параметр packageDependencyId или packageDependencyContext имеет значение NULL для входных данных. |
Замечания
См. примечания AddPackageDependency.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows 11 версии 23H2 (10.0; Сборка 22631) |
заголовка | appmodel.h |