Função MddBootstrapInitialize (mddbootstrap.h)

2025-03-22

Inicializa o processo de chamada para usar a versão do pacote da estrutura do SDK do Aplicativo do Windows que melhor corresponde aos critérios especificados. Essa função destina-se a ser usada por aplicativos da área de trabalho que são empacotados com localização externa ou desempacotados.

MddBootstrapInitialize2 oferece melhorias de usabilidade e solução de problemas em MddBootstrapInitialize.

Consulte também constantes de.

Sintaxe

HRESULT MddBootstrapInitialize(
  UINT32          majorMinorVersion,
  PCWSTR          versionTag,
  PACKAGE_VERSION minVersion
);

Parâmetros

majorMinorVersion

Tipo: UINT32

A versão principal e secundária do SDK do Aplicativo do Windows de produtos a serem carregados (por exemplo, 1.2). Esta é uma versão exata principal e secundária a ser correspondida; não é o mínimo.

majorMinorVersion é codificado como 0xMMMMNNNN, em que M = Major e N = Minor (por exemplo, a versão 1.2 é codificada como 0x00010002).

versionTag

Tipo: PCWSTR

A marca de versão do pacote da estrutura do SDK do Aplicativo do Windows a ser carregada (se houver). Por exemplo, "prerelease".

minVersion

Tipo: PACKAGE_VERSION

A versão mínima do pacote de do SDK de Aplicativo do Windows (que também corresponde majorMinorVersion) a ser usada.

Esta versão (por exemplo, 0.319.455) é diferente do SDK do Aplicativo do Windows versão versão (por exemplo, 1.0.2) e versão do produto (por exemplo, 1.0).

Os valores de versão de runtime do SDK do Aplicativo Windows podem ser obtidos do cabeçalho C++ WindowsAppSDK-VersionInfo.h, consulte Exemplo para obter mais detalhes.

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.

Observações

Todos os erros são registrados no canal de Aplicativo do EventLog.

Você pode chamar essa função várias vezes desde que os parâmetros sejam compatíveis. A primeira chamada faz o trabalho para resolver um pacote de do Framework; as chamadas subsequentes são uma no-op desde que os parâmetros sejam compatíveis com o pacote Framework resolvido pela primeira chamada. Se os parâmetros das chamadas subsequentes não forem compatíveis, a API falhará e retornará um erro.

Essa função localiza um pacote de estrutura do SDK de Aplicativo do Windows que atende aos critérios especificados e disponibiliza o pacote para uso pelo processo atual. Se vários pacotes atenderem aos critérios, essa função selecionará o melhor candidato.

Essa função deve ser chamada na inicialização antes de chamar outras APIs do SDK de Aplicativo do Windows para garantir que o componente bootstrapper possa inicializar corretamente o SDK do Aplicativo do Windows e adicionar a referência de runtime ao pacote da estrutura.

Essa função também inicializa o DDLM (Gerenciador de Tempo de Vida de Dependência Dinâmica). O DDLM fornece infraestrutura para impedir que o sistema operacional (SISTEMA Operacional) atue com o pacote da estrutura do SDK do Aplicativo windows enquanto ele está sendo usado por um aplicativo não empacotado.

Consulte também Usar o runtime do SDK do Aplicativo windows para aplicativos empacotados com local externo ounão empacotados.

Observação

O COM deve ser inicializado para o thread atual antes de chamar essa função.

Observação

Para que essa API tenha êxito em um aplicativo não empacotado, é necessário que os pacotes do SDK de Aplicativos do Windows sejam instalados no dispositivo (consulte a seção Pré-requisitos no Tutorial: Use a API bootstrapper em um aplicativo empacotado com local externo ou desempacotado que usa o SDK do Windows App).

Exemplo

Veja o exemplo em MddBootstrapInitialize2.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1809 (com o SDK do Aplicativo do Windows 1.0 ou posterior)
cabeçalho	mddbootstrap.h
Biblioteca	Microsoft.WindowsAppRuntime.Bootstrap.lib
de DLL	Microsoft.WindowsAppRuntime.Bootstrap.dll

Compartilhar via