CoInitialize 함수(objbase.h)

  • 아티클

현재 스레드에서 COM 라이브러리를 초기화하고 동시성 모델을 STA(단일 스레드 아파트)로 식별합니다.

새 애플리케이션은 CoInitialize 대신 CoInitializeEx 를 호출해야 합니다.

Windows 런타임 사용하려면 RoInitialize 또는 Windows::Foundation::Initialize를 대신 호출해야 합니다.

구문

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

매개 변수

[in, optional] pvReserved

이 매개 변수는 예약되어 있으며 NULL이어야 합니다.

반환 값

이 함수는 다음 값뿐만 아니라 E_INVALIDARG, E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값을 반환할 수 있습니다.

반환 코드 설명
S_OK
 COM 라이브러리가 이 스레드에서 성공적으로 초기화되었습니다.
S_FALSE
 COM 라이브러리는 이 스레드에서 이미 초기화되어 있습니다.
RPC_E_CHANGED_MODE
 CoInitializeEx에 대한 이전 호출은 이 스레드의 동시성 모델을 MTA(다중 스레드 아파트)로 지정했습니다. 이는 중립 스레드 아파트에서 단일 스레드 아파트로의 변경이 발생했음을 나타낼 수도 있습니다.

설명

표준 할당자 및 메모리 할당 함수에 대한 포인터를 얻으려면 CoGetMalloc를 제외한 라이브러리 함수를 호출하기 전에 스레드에서 COM 라이브러리를 초기화해야 합니다.

스레드에 대한 동시성 모델을 설정한 후에는 변경할 수 없습니다. 이전에 다중 스레드로 초기화된 아파트에서 CoInitialize 를 호출하면 실패하고 RPC_E_CHANGED_MODE 반환됩니다.

CoInitializeEx 는 CoInitialize 와 동일한 기능을 제공하며 스레드의 동시성 모델을 명시적으로 지정하는 매개 변수도 제공합니다. CoInitialize 는 CoInitializeEx 를 호출하고 동시성 모델을 단일 스레드 아파트로 지정합니다. 현재 개발된 애플리케이션은 CoInitialize 대신 CoInitializeEx를 호출해야 합니다.

일반적으로 COM 라이브러리는 스레드에서 한 번만 초기화됩니다. 동시성 모델을 변경하려고 시도하지 않고 S_FALSE 반환하는 한 동일한 스레드에서 CoInitialize 또는 CoInitializeEx 에 대한 후속 호출이 성공합니다. COM 라이브러리를 정상적으로 닫려면 S_FALSE 반환하는 라이브러리를 포함하여 CoInitialize 또는 CoInitializeEx에 대한 각 성공적인 호출은 CoUninitialize에 대한 해당 호출을 통해 균형을 유지해야 합니다. 그러나 0으로 CoInitialize (또는 COINIT_APARTMENTTHREADED CoInitializeEx )를 호출하는 애플리케이션의 첫 번째 스레드는 CoUninitialize를 호출할 마지막 스레드여야 합니다. 그렇지 않으면 STA에서 CoInitialize 에 대한 후속 호출이 실패하고 애플리케이션이 작동하지 않습니다.

In Process 서버가 로드되거나 언로드되는 순서를 제어할 방법이 없으므로 DllMain 함수에서 CoInitialize, CoInitializeEx 또는 CoUninitialize를 호출하지 마세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 objbase.h
라이브러리 Ole32.lib
DLL Ole32.dll
API 세트 ext-ms-win-com-sta-l1-1-0(Windows 10 버전 10.0.20166에 도입됨)

추가 정보

CoInitializeEx