IGlobalInterfaceTable::RegisterInterfaceInGlobal 메서드(objidl.h)

프로세스의 한 아파트에 있는 개체에 지정된 인터페이스를 전역 인터페이스로 등록하여 다른 아파트에서 해당 인터페이스에 액세스할 수 있도록 합니다.

구문

HRESULT RegisterInterfaceInGlobal(
  [in]  IUnknown *pUnk,
  [in]  REFIID   riid,
  [out] DWORD    *pdwCookie
);

매개 변수

[in] pUnk

전역으로 등록할 인터페이스가 구현되는 개체에 대한 riid 형식의 인터페이스 포인터입니다.

[in] riid

전역으로 등록할 인터페이스의 IID입니다.

[out] pdwCookie

다른 아파트에서 등록되는 인터페이스에 대한 포인터에 액세스하는 데 사용할 수 있는 식별자입니다. 잘못된 쿠키의 값은 0입니다.

반환 값

이 메서드는 다음 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.

설명

개체의 인터페이스 중 하나를 전역 인터페이스로 등록하기 위해 개체가 상주하는 아파트에서 호출됩니다. 이 메서드는 다른 아파트에서 GetInterfaceFromGlobal 메서드를 호출하여 해당 인터페이스에 대한 포인터를 가져올 수 있는 쿠키에 대한 포인터를 제공합니다.

인터페이스 포인터는 In-Process 개체에 대한 포인터이거나 다른 아파트, 다른 프로세스 또는 다른 컴퓨터에 있는 개체의 프록시에 대한 포인터일 수 있습니다.

이 메서드를 호출하는 아파트는 RevokeInterfaceFromGlobal에 대한 해당 호출까지 활성 상태로 유지되어야 합니다.

요구 사항

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

추가 정보

IGlobalInterfaceTable