Export (0) Print
Expand All

RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN callback function

The RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN is a user-defined callback that can be implemented for each defined interface group. This callback is invoked by the RPC runtime when it detects that the idle state of an interface group has changed.

Syntax


void RPC_ENTRY RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN(
  _In_  RPC_INTERFACE_GROUP IfGroup,
  _In_  void *IdleCallbackContext,
  _In_  unsigned long IsGroupIdle
);

Parameters

IfGroup [in]

A RPC_INTERFACE_GROUP from RpcServerInterfaceGroupCreate that defines the interface group for which the idle state has changed.

IdleCallbackContext [in]

A user-defined context provided at interface group creation.

IsGroupIdle [in]

TRUE if the interface group has just become idle. FALSE if the interface group was previously idle but has since received new activity.

Return value

This callback function does not return a value.

Remarks

When a server registers an interface group, it provides a pointer to an idle callback function through which RPC will notify the application when the interface group’s idle state has changed. The server application can use this callback to attempt to deactivate the interface group when it becomes idle.

RpcServerInterfaceGroupClose must not be called from this callback or deadlock can occur.

Note that RPC server activity is not always visible to the server application. In some cases, simply having a client with an open connection to the server may keep it active even if no calls have been dispatched for a long period of time. Server applications must not rely on any correlation between the RPC runtime declaring that the group is idle and the time since the last call was dispatched.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Rpcdce.h (include Rpc.h)

See also

RpcServerInterfaceGroupActivate
RpcServerInterfaceGroupClose
RpcServerInterfaceGroupCreate
RpcServerInterfaceGroupDeactivate
RpcServerInterfaceGroupInqBindings

 

 

Community Additions

ADD
Show:
© 2014 Microsoft