RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN Rückruffunktion (rpcdce.h)

  • Artikel

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

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupAktivieren

RpcServerInterfaceGroupInqBindings