Compartilhar via


Função RoInitialize (roapi.h)

Inicializa o Windows Runtime no thread atual com o modelo de simultaneidade especificado.

Sintaxe

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

Parâmetros

[in] initType

Tipo: RO_INIT_TYPE

O modelo de simultaneidade para o thread. O padrão é RO_INIT_MULTITHREADED.

Valor de retorno

Tipo: HRESULT

Essa função pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Description
S_OK
O Windows Runtime foi inicializado com êxito neste thread.
S_FALSE
O Windows Runtime já está inicializado neste thread.
RPC_E_CHANGED_MODE
Uma chamada anterior para RoInitialize especificou o modelo de simultaneidade para esse thread como MTA (multithread apartment). Isso também pode indicar que ocorreu uma alteração de apartamento com thread neutro para apartamento de thread único.

Observações

Use a função RoInitialize para inicializar um thread no Windows Runtime. Todos os threads que ativam e interagem com objetos do Windows Runtime devem ser inicializados antes de chamar o Windows Runtime.

Chame a função RoUninitialize para fechar o Windows Runtime no thread atual. Cada chamada bem-sucedida para RoInitialize, incluindo aquelas que retornam S_FALSE, deve ser balanceada por uma chamada correspondente para RoUninitialize.

Requirements

Requirement Value
Cliente mínimo suportado Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
da Plataforma de Destino Windows
Header roapi.h
Library mincore.lib

Consulte também

CoInitializeEx

RO_INIT_TYPE

RoUninitialize