RpcServerRegisterIf 함수(rpcdce.h)

아티클
08/25/2023

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는 서버가 클라이언트에서 원격 프로시저 호출 요청을 받을 때 실행되는 관리자 루틴을 결정합니다.

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

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

요구 사항

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