RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN 콜백 함수(rpcdce.h)

아티클
03/01/2024

RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN 정의된 각 인터페이스 그룹에 대해 구현할 수 있는 사용자 정의 콜백입니다. 이 콜백은 인터페이스 그룹의 유휴 상태가 변경되었음을 감지할 때 RPC 런타임에서 호출됩니다.

구문

RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN RpcInterfaceGroupIdleCallbackFn;

void RpcInterfaceGroupIdleCallbackFn(
  [in] RPC_INTERFACE_GROUP IfGroup,
  [in] void *IdleCallbackContext,
  [in] unsigned long IsGroupIdle
)
{...}

매개 변수

[in] IfGroup

유휴 상태가 변경된 인터페이스 그룹을 정의하는 RpcServerInterfaceGroupCreate의 RPC_INTERFACE_GROUP.

[in] IdleCallbackContext

인터페이스 그룹을 만들 때 제공되는 사용자 정의 컨텍스트입니다.

[in] IsGroupIdle

인터페이스 그룹이 유휴 상태가 된 경우 TRUE입니다. 인터페이스 그룹이 이전에 유휴 상태였지만 이후 새 활동을 받은 경우 FALSE입니다.

반환 값

없음

설명

서버는 인터페이스 그룹을 등록할 때 인터페이스 그룹의 유휴 상태가 변경될 때 RPC가 애플리케이션에 알리는 유휴 콜백 함수에 대한 포인터를 제공합니다. 서버 애플리케이션은 이 콜백을 사용하여 유휴 상태가 되면 인터페이스 그룹을 비활성화하려고 시도할 수 있습니다.

이 콜백에서 RpcServerInterfaceGroupClose를 호출하면 안 되며 교착 상태가 발생할 수 있습니다.

RPC 서버 작업이 서버 애플리케이션에 항상 표시되는 것은 아닙니다. 경우에 따라 서버에 대한 열린 연결이 있는 클라이언트만 있으면 오랜 기간 동안 디스패치된 호출이 없더라도 클라이언트를 활성 상태로 유지할 수 있습니다. 서버 애플리케이션은 그룹이 유휴 상태임을 선언하는 RPC 런타임과 마지막 호출이 디스패치된 이후 시간 간의 상관 관계를 사용하지 않아야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	rpcdce.h(Rpc.h 포함)