RoInitialize 함수(roapi.h)

  • 아티클

지정된 동시성 모델을 사용하여 현재 스레드의 Windows 런타임 초기화합니다.

구문

HRESULT RoInitialize(
  [in] RO_INIT_TYPE initType
);

매개 변수

[in] initType

형식: RO_INIT_TYPE

스레드에 대한 동시성 모델입니다. 기본값은 RO_INIT_MULTITHREADED.

반환 값

형식: HRESULT

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

반환 코드 Description
S_OK
 Windows 런타임 이 스레드에서 성공적으로 초기화되었습니다.
S_FALSE
 이 스레드에서 Windows 런타임 이미 초기화되어 있습니다.
RPC_E_CHANGED_MODE
 RoInitialize에 대한 이전 호출은 이 스레드의 동시성 모델을 MTA(다중 스레드 아파트)로 지정했습니다. 이것은 또한 중립 스레드 아파트에서 단일 스레드 아파트로의 변경이 발생했음을 나타낼 수 있습니다.

설명

RoInitialize 함수를 사용하여 Windows 런타임 스레드를 초기화합니다. Windows 런타임 개체를 활성화하고 상호 작용하는 모든 스레드는 Windows 런타임 호출하기 전에 초기화해야 합니다.

RoUninitialize 함수를 호출하여 현재 스레드의 Windows 런타임 닫습니다. S_FALSE 반환하는 호출을 포함하여 RoInitialize에 대한 각 성공적인 호출은 RoUninitialize에 대한 해당 호출을 통해 균형을 유지해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 roapi.h

추가 정보

CoInitializeEx

RO_INIT_TYPE

RoUninitialize