Partilhar via

Função MddBootstrapInitialize2 (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, com opções. 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 MddBootstrapInitialize2(
  UINT32                        majorMinorVersion,
  PCWSTR                        versionTag,
  PACKAGE_VERSION               minVersion,
  MddBootstrapInitializeOptions options
);

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.

options

Tipo: MddBootstrapInitializeOptions

Opções para inicialização do bootstrapper.

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

Se em opções você não especificar MddBootstrapInitializeOptions::MddBootstrapInitializeOptions_OnPackageIdentity_NOOP, para que essa API tenha êxito em um aplicativo empacotado com local externo ou não empacotado, será necessário que os pacotes de SDK do Aplicativo Windows sejam instalados no dispositivo (confira Tutorial: Usar a API do bootstrapper em um aplicativo empacotado com local externo ou não empacotado que usa o SDK do Aplicativo Windows).

Exemplo

#include <WindowsAppSDK-VersionInfo.h>
#include <MddBootstrap.h>
// ...

if (FAILED(MddBootstrapInitialize(Microsoft::WindowsAppSDK::Release::MajorMinor, Microsoft::WindowsAppSDK::Release::VersionTag, Microsoft::WindowsAppSDK::Runtime::UInt64))) {
    throw std::exception("Error in Bootstrap initialization");
}

#include <WindowsAppSDK-VersionInfo.h>
#include <MddBootstrap.h>
// ...

HRESULT hr = MddBootstrapInitialize(WINDOWSAPPSDK_RELEASE_MAJORMINOR, WINDOWSAPPSDK_RELEASE_VERSION_TAG_W, WINDOWSAPPSDK_RUNTIME_VERSION_UINT64);
if (FAILED(hr))
{
    wprintf(L"Error 0x%X in Bootstrap initialization\n", hr);
}

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