RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN Rückruffunktion (rpcdce.h)
Die RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN ist ein benutzerdefinierter Rückruf, der für jede definierte Schnittstellengruppe implementiert werden kann. Dieser Rückruf wird von der RPC-Runtime aufgerufen, wenn erkannt wird, dass sich der Leerlaufzustand einer Schnittstellengruppe geändert hat.
Syntax
RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN RpcInterfaceGroupIdleCallbackFn;
void RpcInterfaceGroupIdleCallbackFn(
[in] RPC_INTERFACE_GROUP IfGroup,
[in] void *IdleCallbackContext,
[in] unsigned long IsGroupIdle
)
{...}
Parameter
[in] IfGroup
Ein RPC_INTERFACE_GROUP von RpcServerInterfaceGroupCreate , der die Schnittstellengruppe definiert, für die sich der Leerlaufzustand geändert hat.
[in] IdleCallbackContext
Ein benutzerdefinierter Kontext, der bei der Erstellung von Schnittstellengruppen bereitgestellt wird.
[in] IsGroupIdle
TRUE , wenn die Schnittstellengruppe gerade im Leerlauf ist. FALSE , wenn sich die Schnittstellengruppe zuvor im Leerlauf befand, aber seitdem eine neue Aktivität erhalten hat.
Rückgabewert
Keine
Bemerkungen
Wenn ein Server eine Schnittstellengruppe registriert, stellt er einen Zeiger auf eine Rückruffunktion im Leerlauf bereit, über die RPC die Anwendung benachrichtigt, wenn sich der Leerlaufzustand der Schnittstellengruppe geändert hat. Die Serveranwendung kann diesen Rückruf verwenden, um zu versuchen, die Schnittstellengruppe zu deaktivieren, wenn sie im Leerlauf ist.
RpcServerInterfaceGroupClose darf von diesem Rückruf nicht aufgerufen werden, oder es kann ein Deadlock auftreten.
Beachten Sie, dass die RPC-Serveraktivität für die Serveranwendung nicht immer sichtbar ist. In einigen Fällen kann es sein, dass einfach ein Client mit einer offenen Verbindung mit dem Server aktiv bleibt, auch wenn über einen längeren Zeitraum keine Anrufe versendet wurden. Serveranwendungen dürfen sich nicht auf eine Korrelation zwischen der RPC-Laufzeit, die deklariert, dass sich die Gruppe im Leerlauf befindet, und der Zeit seit der Versendung des letzten Aufrufs basieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | rpcdce.h (include Rpc.h) |
Weitere Informationen
RpcServerInterfaceGroupActivate