RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN fonction de rappel (rpcdce.h)
Le RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN est un rappel défini par l’utilisateur qui peut être implémenté pour chaque groupe d’interfaces défini. Ce rappel est appelé par le runtime RPC lorsqu’il détecte que l’état d’inactivité d’un groupe d’interfaces a changé.
Syntaxe
RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN RpcInterfaceGroupIdleCallbackFn;
void RpcInterfaceGroupIdleCallbackFn(
[in] RPC_INTERFACE_GROUP IfGroup,
[in] void *IdleCallbackContext,
[in] unsigned long IsGroupIdle
)
{...}
Paramètres
[in] IfGroup
Une RPC_INTERFACE_GROUP de RpcServerInterfaceGroupCreate qui définit le groupe d’interfaces pour lequel l’état d’inactivité a changé.
[in] IdleCallbackContext
Contexte défini par l’utilisateur fourni lors de la création du groupe d’interface.
[in] IsGroupIdle
TRUE si le groupe d’interfaces vient de devenir inactif. FALSE si le groupe d’interfaces était précédemment inactif, mais a depuis reçu une nouvelle activité.
Valeur de retour
None
Remarques
Lorsqu’un serveur inscrit un groupe d’interfaces, il fournit un pointeur vers une fonction de rappel inactive par le biais de laquelle RPC notifie l’application lorsque l’état d’inactivité du groupe d’interfaces a changé. L’application serveur peut utiliser ce rappel pour tenter de désactiver le groupe d’interfaces lorsqu’il devient inactif.
RpcServerInterfaceGroupClose ne doit pas être appelé à partir de ce rappel, sinon un blocage peut se produire.
Notez que l’activité du serveur RPC n’est pas toujours visible par l’application serveur. Dans certains cas, le simple fait d’avoir un client avec une connexion ouverte au serveur peut le maintenir actif même si aucun appel n’a été distribué pendant une longue période. Les applications serveur ne doivent pas s’appuyer sur une corrélation entre le runtime RPC déclarant que le groupe est inactif et l’heure depuis la distribution du dernier appel.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | rpcdce.h (inclure Rpc.h) |
Voir aussi
RpcServerInterfaceGroupActivate