Função RpcMgmtStopServerListening (rpcdce.h)

  • Artigo

A função RpcMgmtStopServerListening informa a um servidor para parar de escutar chamadas de procedimento remoto. Essa função não afetará as interfaces de escuta automática. Consulte RpcServerRegisterIfEx para obter mais detalhes.

Sintaxe

RPC_STATUS RpcMgmtStopServerListening(
  RPC_BINDING_HANDLE Binding
);

Parâmetros

Binding

Para direcionar um aplicativo remoto para parar de escutar chamadas de procedimento remoto, especifique um identificador de associação de servidor para esse aplicativo. Para direcionar seu próprio aplicativo (local) para parar de escutar chamadas de procedimento remoto, especifique um valor nulo.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_INVALID_BINDING
 O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING
 Esse era o tipo errado de associação para a operação.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Um aplicativo chama a função RpcMgmtStopServerListening para direcionar um servidor a parar de escutar chamadas de procedimento remoto. Se DontWait for TRUE, o aplicativo deverá chamar RpcMgmtWaitServerListen para aguardar a conclusão de todas as chamadas.

Quando recebe uma solicitação de parada de escuta, a biblioteca de tempo de execução RPC para de aceitar novas chamadas de procedimento remoto para todas as interfaces registradas. A execução de chamadas tem permissão para ser concluída, incluindo retornos de chamada. Depois que todas as chamadas forem concluídas, essa função sinalizará a função RpcServerListen de que ela deve parar de escutar e retornar ao chamador. Se o parâmetro DontWait de RpcServerListen foi definido como TRUE, o aplicativo chama RpcMgmtWaitServerListen para que todas as chamadas restantes sejam concluídas.

Nota Do lado do cliente, RpcMgmtStopServerListening está desabilitado por padrão. Para habilitar essa função, crie uma função de autorização em seu aplicativo de servidor que retorna TRUE (para permitir um desligamento remoto) sempre que RpcMgmtStopServerListening for chamado. Use RpcMgmtSetAuthorizationFn para dar ao cliente acesso à função de gerenciamento.
 
O servidor deve estar escutando chamadas de procedimento remoto para que essa função tenha êxito. Se o servidor não estiver escutando, a função falhará.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx