RpcServerInterfaceGroupActivate 함수(rpcdce.h)
RpcServerInterfaceGroupActivate 함수는 RPC 서버 런타임에 인터페이스 그룹의 인터페이스 및 엔드포인트를 등록하고 호출 수신 대기를 시작하도록 지시합니다.
구문
RPC_STATUS RpcServerInterfaceGroupActivate(
[in] RPC_INTERFACE_GROUP IfGroup
);
매개 변수
[in] IfGroup
활성화할 인터페이스 그룹을 정의하는 RpcServerInterfaceGroupCreate의 RPC_INTERFACE_GROUP.
반환 값
| 값 | 의미 |
|---|---|
|
호출이 성공했습니다. |
|
프로토콜 시퀀스는 이 호스트에서 지원되지 않습니다. |
|
프로토콜 시퀀스가 잘못되었습니다. |
|
엔드포인트 형식이 잘못되었습니다. |
|
시스템이 메모리가 부족합니다. |
|
엔드포인트 또는 인터페이스에 대한 보안 설명자가 잘못되었습니다. |
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
설명
RpcServerInterfaceGroupActivate 는 RPC 서버 애플리케이션에서 수행해야 하는 대부분의 초기화 작업을 수행합니다. 다음 작업을 수행합니다.
- RPC 런타임에 호출 수신 대기를 시작하도록 지시합니다.
- 서버 런타임에 엔드포인트를 등록합니다.
- 서버 런타임에 인터페이스를 등록합니다.
- RPC 엔드포인트 매퍼에 엔드포인트 및 인터페이스를 등록합니다.
RpcServerInterfaceGroupActivate 는 원자성입니다. 작업이 실패하면 이전에 등록된 모든 항목이 실행 취소됩니다.
이 함수가 반환되기 전에 서버 애플리케이션에 호출을 디스패치할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | rpcdce.h(Rpc.h 포함) |
| 라이브러리 | Rpcrt4.lib |
| DLL | Rpcrt4.dll |