Como escutar as chamadas do cliente

Depois que o aplicativo de servidor tiver registrado suas interfaces, criado as informações de associação necessárias e registrado seus pontos de extremidade, ele estará pronto para começar a escutar chamadas de procedimento remoto de programas cliente.

Para escutar chamadas de procedimento remoto, seu programa de servidor deve chamar RpcServerListen, conforme mostrado no seguinte fragmento de código:

RPC_STATUS status;
status = RpcServerListen(
    1,
    RPC_C_LISTEN_MAX_CALLS_DEFAULT,
    0);

Um RPC Server tem um ou mais threads que captam chamadas de cliente e as entregam às rotinas nas interfaces registradas. O primeiro parâmetro para a função RpcServerListen é o número mínimo de threads a serem criados. O parâmetro é apenas uma dica; O tempo de execução do RPC pode optar por ignorá-lo.

O segundo parâmetro para RpcServerListen é o número máximo de chamadas de procedimento remoto simultâneas a serem tratadas. Se você quiser que seu aplicativo use o valor máximo padrão, passe RPC_C_LISTEN_MAX_CALLS_DEFAULT como o valor para esse parâmetro.

A especificação de DCE exige que RpcServerListen continue em execução até receber um sinal para parar. Uma extensão da Microsoft para essa função é permitir que ela comece a escutar e retornar imediatamente. Se você quiser que seu aplicativo use o comportamento de DCE padrão, defina o terceiro parâmetro como zero. Consulte RpcServerListen, RpcMgmtStopServerListening e RpcMgmtWaitServerListen para obter detalhes.