RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN función de devolución de llamada (rpcdce.h)

El RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN es una devolución de llamada definida por el usuario que se puede implementar para cada grupo de interfaz definido. El tiempo de ejecución de RPC invoca esta devolución de llamada cuando detecta que el estado inactivo de un grupo de interfaz ha cambiado.

Sintaxis

RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN RpcInterfaceGroupIdleCallbackFn;

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

Parámetros

[in] IfGroup

Un RPC_INTERFACE_GROUP de RpcServerInterfaceGroupCreate que define el grupo de interfaz para el que ha cambiado el estado inactivo.

[in] IdleCallbackContext

Contexto definido por el usuario proporcionado en la creación del grupo de interfaz.

[in] IsGroupIdle

TRUE si el grupo de interfaz acaba de estar inactivo. FALSE si el grupo de interfaz estaba inactivo anteriormente, pero ha recibido una nueva actividad.

Valor devuelto

None

Observaciones

Cuando un servidor registra un grupo de interfaz, proporciona un puntero a una función de devolución de llamada inactiva a través de la cual RPC notificará a la aplicación cuando el estado de inactividad del grupo de interfaz haya cambiado. La aplicación de servidor puede usar esta devolución de llamada para intentar desactivar el grupo de interfaz cuando se vuelve inactivo.

No se debe llamar a RpcServerInterfaceGroupClose desde esta devolución de llamada o interbloqueo.

Tenga en cuenta que la actividad del servidor RPC no siempre es visible para la aplicación de servidor. En algunos casos, simplemente tener un cliente con una conexión abierta al servidor puede mantenerlo activo incluso si no se han enviado llamadas durante un largo período de tiempo. Las aplicaciones de servidor no deben basarse en ninguna correlación entre el tiempo de ejecución de RPC que declara que el grupo está inactivo y el tiempo desde que se envió la última llamada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rpcdce.h (incluir Rpc.h)

Consulte también

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings