RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN função de retorno de chamada (rpcdce.h)

O RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN é um retorno de chamada definido pelo usuário que pode ser implementado para cada grupo de interface definido. Esse retorno de chamada é invocado pelo runtime do RPC quando detecta que o estado ocioso de um grupo de interfaces foi alterado.

Sintaxe

RPC_INTERFACE_GROUP_IDLE_CALLBACK_FN RpcInterfaceGroupIdleCallbackFn;

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

Parâmetros

[in] IfGroup

Um RPC_INTERFACE_GROUP de RpcServerInterfaceGroupCreate que define o grupo de interfaces para o qual o estado ocioso foi alterado.

[in] IdleCallbackContext

Um contexto definido pelo usuário fornecido na criação do grupo de interfaces.

[in] IsGroupIdle

TRUE se o grupo de interfaces acabou de ficar ocioso. FALSE se o grupo de interface estava ocioso anteriormente, mas desde então recebeu uma nova atividade.

Retornar valor

Nenhum

Comentários

Quando um servidor registra um grupo de interfaces, ele fornece um ponteiro para uma função de retorno de chamada ociosa por meio da qual o RPC notificará o aplicativo quando o estado ocioso do grupo de interfaces for alterado. O aplicativo de servidor pode usar esse retorno de chamada para tentar desativar o grupo de interfaces quando ele ficar ocioso.

RpcServerInterfaceGroupClose não deve ser chamado desse retorno de chamada ou o deadlock pode ocorrer.

Observe que a atividade do servidor RPC nem sempre é visível para o aplicativo de servidor. Em alguns casos, simplesmente ter um cliente com uma conexão aberta com o servidor pode mantê-lo ativo mesmo que nenhuma chamada tenha sido enviada por um longo período de tempo. Os aplicativos de servidor não devem depender de nenhuma correlação entre o runtime do RPC declarando que o grupo está ocioso e a hora desde que a última chamada foi expedida.

Requisitos

Confira também

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings