CoRegisterSurrogate 함수(combaseapi.h)

  • 아티클

해당 ISurrogate 인터페이스 포인터를 통해 서로게이트 프로세스를 등록합니다.

구문

HRESULT CoRegisterSurrogate(
  [in] LPSURROGATE pSurrogate
);

매개 변수

[in] pSurrogate

등록할 서로게이트 프로세스의 ISurrogate 인터페이스에 대한 포인터입니다.

반환 값

이 함수는 서로게이트 프로세스가 성공적으로 등록되었음을 나타내는 S_OK 반환합니다.

설명

CoRegisterSurrogate 함수는 서로게이트 프로세스에 구현된 ISurrogate 인터페이스에 대한 전역 인터페이스 포인터를 설정합니다. 이 포인터는 서로게이트 프로세스에 로드된 ole32 DLL에서 설정됩니다. COM은 ole32에서 이 전역 포인터를 사용하여 ISurrogate의 메서드를 호출합니다. 이 함수는 일반적으로 서로게이트 구현이 시작될 때 호출됩니다.

Windows Server 2003을 기준으로 COM 개체 애플리케이션이 서비스로 등록된 경우 COM은 등록을 확인합니다. COM은 SCM(서비스 제어 관리자)에서 서비스의 프로세스 ID가 등록 프로세스의 프로세스 ID와 일치하는지 확인합니다. 그렇지 않은 경우 COM이 등록에 실패합니다.

요구 사항

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

추가 정보

ISurrogate

사용자 지정 서로게이트 작성