Função Initialize (roapi.h)

  • Artigo

Inicializa um thread para usar APIs Windows Runtime.

Sintaxe

HRESULT Initialize(
  RO_INIT_TYPE initType
);

Parâmetros

initType

Especifica o tipo de apartment do thread a ser inicializado.

Retornar valor

  • S_OK - Inicializado com êxito pela primeira vez no thread atual
  • S_FALSE - Inicialização aninhada bem-sucedida (o thread atual já foi inicializado para o tipo de apartment especificado)
  • E_INVALIDARG – valor inválido initType
  • CO_E_INIT_TLS – Falha ao alocar a estrutura TLS interna do COM
  • E_OUTOFMEMORY – Falha ao alocar estruturas por thread/por apartamento diferentes do TLS
  • RPC_E_CHANGED_MODE - O thread atual já está inicializado para um tipo de apartamento diferente do especificado.

Comentários

Windows::Foundation::Initialize é alterado para criar ASTAs em vez de STAs clássicas para o valor RO_INIT_TYPE RO_INIT_SINGLETHREADED. Windows::Foundation::Initialize(RO_INIT_SINGLETHREADED) não tem suporte para aplicativos da área de trabalho e retornará CO_E_NOTSUPPORTED se for chamado de um processo diferente de um aplicativo da Windows Store.

Para aplicativos Microsoft DirectX, você deve inicializar o thread inicial usando Windows::Foundation::Initialize(RO_INIT_MULTITHREADED).

Para um servidor EXE fora do processo, você deve inicializar o thread inicial do servidor usando Windows::Foundation::Initialize(RO_INIT_MULTITHREADED).

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho roapi.h

Confira também

RO_INIT_TYPE