Compartilhar via

Função AddPackageDependency2 (appmodel.h)

  • Artigo

Adiciona uma referência em tempo de execução para a dependência do pacote de estrutura que você criou anteriormente usando o método tryCreatePackageDependency, com as opções especificadas. Depois que esse método for retornado com êxito, seu aplicativo poderá ativar tipos e usar o conteúdo do pacote da estrutura.

Sintaxe

HRESULT AddPackageDependency2(
  PCWSTR                       packageDependencyId,
  INT32                        rank,
  AddPackageDependencyOptions2 options,
  PACKAGEDEPENDENCY_CONTEXT    *packageDependencyContext,
  PWSTR                        *packageFullName
);

Parâmetros

packageDependencyId

Tipo: PCWSTR

A ID da dependência do pacote a ser resolvida e adicionada ao grafo de pacote do processo de invocação. Esse parâmetro deve corresponder a uma dependência de pacote definida usando a função TryCreatePackageDependency para o usuário chamador ou o sistema (por meio da opção CreatePackageDependencyOptions_ScopeIsSystem) ou então um erro é retornado.

rank

Tipo: INT32

A classificação a ser usada para adicionar o pacote resolvido ao grafo de pacote do chamador. Para obter mais informações, consulte Comentários.

options

Tipo: AddPackageDependencyOptions2

As opções a serem aplicadas ao adicionar a dependência do pacote.

packageDependencyContext

Tipo: * PACKAGEDEPENDENCY_CONTEXT*

O identificador da dependência de pacote adicionada. Esse identificador é válido até ser passado para removePackageDependency.

packageFullName

Tipo: PCWSTR*

Quando esse método é retornado, contém o endereço de um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome completo do pacote para o qual a dependência foi resolvida. O chamador é responsável por liberar esse recurso depois que ele não é mais necessário chamando heapfree.

Valor de retorno

Tipo: HRESULT

Se a função for bem-sucedida, ela retornará ERROR_SUCCESS. Caso contrário, a função retornará um código de erro. Os códigos de erro possíveis incluem o seguinte.

Código de retorno Descrição
E_INVALIDARG O parâmetro packageDependencyId ou packageDependencyContext é NULL na entrada.

Observações

Consulte de Comentários para AddPackageDependency.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 11, versão 23H2 (10.0; Build 22631)
cabeçalho appmodel.h

Consulte também