共用方式為


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