RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN回调函数 (rpcdce.h)

项目
03/05/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)