Condividi tramite


RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN funzione di callback (rpcdce.h)

Il RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN è un callback definito dall'utente che può essere implementato per ogni gruppo di interfacce definito. Questo callback viene richiamato dal runtime RPC quando rileva che lo stato di inattività di un gruppo di interfacce è stato modificato.

Sintassi

RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN RpcInterfaceGroupIdleCallbackFn;

void RpcInterfaceGroupIdleCallbackFn(
  [in] RPC_INTERFACE_GROUP IfGroup,
  [in] void *IdleCallbackContext,
  [in] unsigned long IsGroupIdle
)
{...}

Parametri

[in] IfGroup

Oggetto RPC_INTERFACE_GROUP da RpcServerInterfaceGroupCreate che definisce il gruppo di interfaccia per cui è stato modificato lo stato di inattività.

[in] IdleCallbackContext

Contesto definito dall'utente fornito durante la creazione del gruppo di interfacce.

[in] IsGroupIdle

TRUE se il gruppo di interfacce è appena diventato inattiva. FALSE se il gruppo di interfaccia era inattivo in precedenza ma ha ricevuto una nuova attività.

Valore restituito

nessuno

Osservazioni

Quando un server registra un gruppo di interfacce, fornisce un puntatore a una funzione di callback inattiva tramite cui RPC notifica all'applicazione quando lo stato di inattività del gruppo di interfacce è cambiato. L'applicazione server può usare questo callback per tentare di disattivare il gruppo di interfacce quando diventa inattivo.

RpcServerInterfaceGroupClose non deve essere chiamato da questo callback o deadlock.

Si noti che l'attività del server RPC non è sempre visibile all'applicazione server. In alcuni casi, la semplice presenza di un client con una connessione aperta al server può mantenerla attiva anche se non sono state inviate chiamate per un lungo periodo di tempo. Le applicazioni server non devono basarsi su alcuna correlazione tra il runtime RPC dichiarando che il gruppo è inattivo e l'ora successiva all'invio dell'ultima chiamata.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione rpcdce.h (include Rpc.h)

Vedi anche

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings