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