GetRunningObjectTable 함수(objbase.h)

  • 아티클

ROT(로컬 실행 개체 테이블)의 IRunningObjectTable 인터페이스에 대한 포인터를 반환합니다.

구문

HRESULT GetRunningObjectTable(
  [in]  DWORD                reserved,
  [out] LPRUNNINGOBJECTTABLE *pprot
);

매개 변수

[in] reserved

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

[out] pprot

로컬 ROT에 대한 인터페이스 포인터 를 수신하는 IRunningObjectTable* 포인터 변수의 주소입니다. 함수가 성공하면 호출자는 인터페이스 포인터에서 Release 를 호출합니다. 오류가 발생하면 *pprot 가 정의되지 않습니다.

반환 값

이 함수는 E_UNEXPECTED 및 S_OK 표준 반환 값을 반환할 수 있습니다.

설명

각 워크스테이션에는 해당 컴퓨터에서 실행 중으로 등록된 개체의 테이블을 유지하는 로컬 ROT가 있습니다. 이 함수는 해당 테이블에 대한 액세스를 제공하는 IRunningObjectTable 인터페이스 포인터를 반환합니다.

다른 사용자가 액세스할 수 있도록 개체를 식별하는 모니커를 나눠주는 모니커 공급자는 GetRunningObjectTable을 호출해야 합니다. 이 함수에서 반환한 인터페이스 포인터를 사용하여 개체가 실행되기 시작할 때 등록하고, 해당 개체가 수정된 시간을 기록하고, 실행이 중지될 때 등록을 취소합니다. 자세한 내용은 IRunningObjectTable 인터페이스를 참조하세요.

복합 문서 링크 원본은 모니커 공급자의 가장 일반적인 예입니다. 여기에는 문서(또는 문서의 일부)에 대한 연결을 지원하는 서버 애플리케이션 및 문서 내의 포함에 대한 연결을 지원하는 컨테이너 애플리케이션이 포함됩니다. 연결을 지원하지 않는 서버 애플리케이션은 ROT를 사용하여 포함에 대한 연결을 지원하는 컨테이너 애플리케이션과 협력할 수도 있습니다.

새 모니커 클래스를 작성하기 위해 IMoniker 인터페이스를 구현하고 ROT에 대한 인터페이스 포인터가 필요한 경우 GetRunningObjectTable 함수 대신 IBindCtx::GetRunningObjectTable을 호출합니다. 이렇게 하면 IBindCtx 인터페이스의 향후 구현에서 바인딩 동작을 수정할 수 있습니다.

요구 사항

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

추가 정보

IBindCtx::GetRunningObjectTable

Imoniker

IRunningObjectTable