Função MddBootstrapInitialize (mddbootstrap.h)

  • Artigo

Inicializa o processo de chamada para usar a versão do pacote de estrutura SDK do Aplicativo 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 local externo ou não empacotados.

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

Consulte também Constantes.

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 Windows produto a ser carregado (por exemplo, 1.2). Esta é uma versão principal e secundária exata para corresponder; não é um 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 SDK do Aplicativo Windows pacote de estrutura a ser carregado (se houver). Por exemplo, "prerelease".

minVersion

Tipo: PACKAGE_VERSION

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

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

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

Retornar valor

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.

Comentários

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

Você pode chamar essa função várias vezes, desde que os parâmetros sejam compatíveis. A primeira chamada funciona para resolve um pacote framework; as chamadas subsequentes são uma no-op fornecida que os parâmetros são 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 SDK do Aplicativo 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 qualquer outra SDK DO APLICATIVO WINDOWS APIs para garantir que o componente bootstrapper possa inicializar corretamente o SDK do Aplicativo Windows e adicionar a referência de runtime ao pacote de estrutura.

Essa função também inicializa o DDLM (Dynamic Dependency Lifetime Manager). O DDLM fornece infraestrutura para impedir que o sistema operacional (SO) atendo o pacote de estrutura de 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 ou nã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 de SDK do Aplicativo Windows sejam instalados no dispositivo (consulte a seção Pré-requisitos em Tutorial: Usar a API de bootstrapper em um aplicativo empacotado com local externo ou não empacotado que usa o SDK do Aplicativo Windows).

Exemplo

Consulte o exemplo em MddBootstrapInitialize2.

Requisitos

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

Confira também