RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN コールバック関数 (rpcdce.h)

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 を含む)

こちらもご覧ください

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings