CoGetObjectContext 함수(combaseapi.h)

현재 개체의 컨텍스트를 반환합니다.

구문

HRESULT CoGetObjectContext(
  [in]  REFIID riid,
  [out] LPVOID *ppv
);

매개 변수

[in] riid

컨텍스트 개체에 구현된 인터페이스의 ID에 대한 참조입니다.

COM 애플리케이션 내에서 실행되는 개체의 경우 IID_IComThreadingInfo, IID_IContext 및 IID_IContextCallback 사용할 수 있습니다.

COM+ 애플리케이션 내에서 실행되는 개체의 경우 IID_IObjectContext, IID_IObjectContextActivity IID_IObjectContextInfo 및 IID_IContextState 사용할 수 있습니다.

[out] ppv

컨텍스트 개체에서 riid 로 지정된 인터페이스에 대한 포인터의 주소입니다.

반환 값

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

반환 코드	Description
S_OK	개체 컨텍스트가 성공적으로 검색되었습니다.
E_NOINTERFACE	요청된 인터페이스를 사용할 수 없습니다.
CO_E_NOTINITIALIZED	이 함수를 호출하려면 현재 스레드에서 CoInitializeEx 함수를 호출해야 합니다.

설명

CoGetObjectContext 는 호출된 개체의 컨텍스트를 검색하고 컨텍스트 속성을 조작하는 데 사용할 수 있는 인터페이스에 대한 포인터를 반환합니다. 컨텍스트 속성은 COM+ 애플리케이션 내에서 실행되는 구성된 구성 요소에 서비스를 제공하는 데 사용됩니다.

COM 애플리케이션 내에서 실행되는 구성 요소의 경우 컨텍스트 속성에 액세스하기 위해 IComThreadingInfo, IContext 및 IContextCallback 인터페이스가 지원됩니다.

COM+ 애플리케이션 내에서 실행되는 구성 요소의 경우 컨텍스트 속성에 액세스하는 데 지원되는 인터페이스는 IObjectContext, IObjectContextActivity, IObjectContextInfo 및 IContextState입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	combaseapi.h(Objbase.h 포함)
라이브러리	Ole32.lib
DLL	Ole32.dll

추가 정보

컨텍스트 및 스레딩 모델