функция обратного вызова 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

RPC_INTERFACE_GROUP из RpcServerInterfaceGroupCreate, определяющий группу интерфейсов, для которой изменилось состояние простоя.

[in] IdleCallbackContext

Определяемый пользователем контекст, предоставляемый при создании группы интерфейсов.

[in] IsGroupIdle

Значение TRUE , если группа интерфейсов только что неактивна. FALSE , если группа интерфейсов ранее простаивала, но с тех пор получила новое действие.

Возвращаемое значение

None

Remarks

Когда сервер регистрирует группу интерфейсов, он предоставляет указатель на функцию обратного вызова бездействия, с помощью которой RPC уведомляет приложение об изменении состояния простоя группы интерфейсов. Серверное приложение может использовать этот обратный вызов, чтобы попытаться отключить группу интерфейсов, когда она простаивает.

RpcServerInterfaceGroupClose не следует вызывать из этого обратного вызова, иначе может возникнуть взаимоблокировка.

Обратите внимание, что активность сервера RPC не всегда видна для серверного приложения. В некоторых случаях простое наличие клиента с открытым подключением к серверу может привести к тому, что он будет активным, даже если в течение длительного периода времени не было отправлено никаких вызовов. Серверные приложения не должны полагаться на корреляцию между средой выполнения RPC, объявляющей, что группа находится в режиме простоя, и временем с момента отправки последнего вызова.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	rpcdce.h (включая Rpc.h)