다음을 통해 공유


RpcServerRegisterIf 함수(rpcdce.h)

RpcServerRegisterIf 함수는 RPC 런타임 라이브러리에 인터페이스를 등록합니다.

구문

RPC_STATUS RpcServerRegisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  RPC_MGR_EPV   *MgrEpv
);

매개 변수

IfSpec

등록할 인터페이스를 나타내는 MIDL 생성 구조체입니다.

MgrTypeUuid

MgrEpv 매개 변수와 연결할 UUID 형식에 대한 포인터입니다. null 매개 변수 값(또는 nil UUID)을 지정하면 IfSpec 이 nil 형식 UUID로 등록됩니다.

MgrEpv

관리자 루틴의 EPV(진입점 벡터). MIDL에서 생성된 기본 EPV를 사용하려면 null 값을 지정합니다. 자세한 내용은 RPC_MGR_EPV 참조하세요.

반환 값

성공 시 RPC_S_OK 반환합니다.

참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
 

설명

서버는 RPC 런타임 라이브러리에 무제한의 인터페이스를 등록할 수 있습니다. 등록하면 서버에 대한 바인딩 핸들을 사용하여 클라이언트에서 인터페이스를 사용할 수 있습니다. 인터페이스를 등록하기 위해 서버 애플리케이션 코드는 RpcServerRegisterIf를 호출합니다. 서버에서 제공하는 인터페이스의 각 구현에 대해 별도의 관리자 EPV를 등록해야 합니다.

RpcServerRegisterIf를 호출할 때 서버는 다음 정보를 제공합니다.

  • 인터페이스 사양

    인터페이스 사양은 MIDL 컴파일러에서 생성하는 데이터 구조입니다. 서버는 IfSpec 매개 변수를 사용하여 인터페이스를 지정합니다.

  • 관리자 유형 UUID 및 관리자 EPV

    관리자는 UUID를 입력하고 관리자 EPV는 서버가 클라이언트에서 원격 프로시저 호출 요청을 받을 때 실행되는 관리자 루틴을 결정합니다.

    서버는 MgrTypeUuidMgrEpv 매개 변수를 사용하여 관리자 유형 UUID 및 EPV를 지정합니다. Nil이 아닌 관리자 형식 UUID를 지정할 때 서버는 RpcObjectSetType 함수를 호출하여 이 nil이 아닌 형식의 개체를 등록해야 합니다.

서버 애플리케이션이 자동 수신 대기 인터페이스를 등록하거나 인증을 위해 콜백 함수를 사용해야 하는 경우 RpcServerRegisterIfEx를 사용합니다.

요구 사항

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

추가 정보

인터페이스 등록

RpcBindingFromStringBinding

RpcBindingSetObject

RpcNsBindingExport

RpcNsBindingImportBegin

RpcNsBindingLookupBegin

RpcObjectSetType

RpcServerRegisterIf2

RpcServerRegisterIf3

RpcServerRegisterIfEx

RpcServerUnregisterIf

RpcServerUnregisterIfEx