Função CoInitialize (objbase.h)

Inicializa a biblioteca COM no thread atual e identifica o modelo de simultaneidade como STA (single-thread apartment).

Novos aplicativos devem chamar CoInitializeEx em vez de CoInitialize.

Se você quiser usar o Windows Runtime, chame RoInitialize ou Windows::Foundation::Initialize.

Sintaxe

HRESULT CoInitialize(
  [in, optional] LPVOID pvReserved
);

Parâmetros

[in, optional] pvReserved

Esse parâmetro é reservado e deve ser NULL.

Valor retornado

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

Comentários

Você precisa inicializar a biblioteca COM em um thread antes de chamar qualquer uma das funções de biblioteca, exceto CoGetMalloc, para obter um ponteiro para o alocador padrão e as funções de alocação de memória.

Depois que o modelo de simultaneidade de um thread for definido, ele não poderá ser alterado. Uma chamada para CoInitialize em um apartamento que foi inicializado anteriormente como multithreaded falhará e retornará RPC_E_CHANGED_MODE.

CoInitializeEx fornece a mesma funcionalidade que CoInitialize e também fornece um parâmetro para especificar explicitamente o modelo de simultaneidade do thread. CoInitialize chama CoInitializeEx e especifica o modelo de simultaneidade como apartment de thread único. Os aplicativos desenvolvidos hoje devem chamar CoInitializeEx em vez de CoInitialize.

Normalmente, a biblioteca COM é inicializada em um thread apenas uma vez. As chamadas subsequentes para CoInitialize ou CoInitializeEx no mesmo thread terão êxito, desde que não tentem alterar o modelo de simultaneidade, mas retornarão S_FALSE. Para fechar a biblioteca COM normalmente, cada chamada bem-sucedida para CoInitialize ou CoInitializeEx, incluindo aquelas que retornam S_FALSE, deve ser balanceada por uma chamada correspondente para CoUninitialize. No entanto, o primeiro thread no aplicativo que chama CoInitialize com 0 (ou CoInitializeEx com COINIT_APARTMENTTHREADED) deve ser o último thread a chamar CoUninitialize. Caso contrário, as chamadas subsequentes para CoInitialize no STA falharão e o aplicativo não funcionará.

Como não há como controlar a ordem na qual os servidores em processo são carregados ou descarregados, não chame CoInitialize, CoInitializeEx ou CoUninitialize da função DllMain .

Requisitos

Confira também

Coinitializeex