Função RoInitialize (roapi.h)

  • Artigo

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.

Retornar valor

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 Descrição
S_OK
 O Windows Runtime foi inicializado com êxito nesse thread.
S_FALSE
 O Windows Runtime já está inicializado nesse 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 mudança de apartamento com thread neutro para apartamento de thread único.

Comentários

Use a função RoInitialize para inicializar um thread no Windows Runtime. Todos os threads que ativam e interagem com objetos 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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho roapi.h

Confira também

Coinitializeex

RO_INIT_TYPE

RoUninitialize