Skip to main content

XPackageEnumeratePackages

Localiza pacotes que já estão instalados, ou sendo instalados, e que estão relacionados ao processo de chamada.

Sintaxe

Parâmetros

kind   _In_
Tipo: XPackageKind
O tipo de pacotes de instalação a serem enumerados. scope   _In_
Tipo: XPackageEnumerationScope
O escopo dos pacotes de instalação. context   _In_opt_
Tipo: void*
Contexto a ser passado para o retorno de chamada especificado no parâmetro callback. callback   _In_
Tipo: XPackageEnumerationCallback*
Um retorno de chamada a ser chamado na conclusão.

Valor retornado

Tipo: HRESULT Código de sucesso ou de erro HRESULT.

Comentários

Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte Threads sensíveis ao tempo.
Use XPackageEnumeratePackages para localizar pacotes que já estão instalados, ou sendo instalados, e que estão relacionados ao processo de chamada. Essa função pode localizar pacotes de conteúdo, bem como pacotes de aplicativos. Ela fornece detalhes sobre uma instalação por meio de uma estrutura XPackageDetails. Se o pacote ainda estiver sendo instalado, a propriedade installing será definida como true e você poderá criar um monitor de instalação para permitir que o identificador do pacote monitore o progresso da instalação. Não há notificações genéricas da fila de instalação; a intenção é usar XPackageEnumeratePackages para mostrar e acompanhar os itens em andamento. Também não há uma API para interromper, iniciar ou cancelar uma instalação. Da perspectiva de um jogo, a instalação deve cuidar de si mesma. Os erros são repetidos automaticamente e são invisíveis para o jogo. A saída da API, quando chamada com o valor XPackageKind::Game, dependendo do valor de XPackageEnumerationScope, será: A saída da API, quando chamada com o valor XPackageKind::Content, dependendo do valor de XPackageEnumerationScope, será: Exemplo:

Requisitos

Cabeçalho: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatíveis: Windows, consoles da família XBOX One e consoles XBOX Series

Documentação conceitual

Confira também

XPackage
Hubs de jogos de franquia
Como criar e usar pacotes de conteúdo para download (DLC) para PC e XBOX One
Last modified on October 6, 2026