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

추가 정보

컨텍스트 및 스레딩 모델