Função RpcMgmtIsServerListening (rpcdce.h)

  • Artigo

A função RpcMgmtIsServerListening informa se um servidor está escutando chamadas de procedimento remoto.

Sintaxe

RPC_STATUS RpcMgmtIsServerListening(
  RPC_BINDING_HANDLE Binding
);

Parâmetros

Binding

Para determinar se um aplicativo remoto está escutando chamadas de procedimento remoto, especifique um identificador de associação de servidor para esse aplicativo. Para determinar se seu próprio aplicativo (local) está escutando chamadas de procedimento remoto, especifique um valor nulo.

Valor retornado

Valor Significado
RPC_S_OK
 Servidor escutando chamadas de procedimento remoto.
RPC_S_NOT_LISTENING
 O servidor não está escutando chamadas de procedimento remoto ou a interface está escutando automaticamente.
RPC_S_INVALID_BINDING
 O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING
 Esse foi 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.
 
 

A função RpcMgmtIsServerListening retorna resultados corretos apenas para interfaces que não estão escutando automaticamente. Se o aplicativo de servidor estiver escutando automaticamente e chamar a função RpcMgmtIsServerListening , RpcMgmtIsServerListening retornará RPC_SERVER_NOT_LISTENING, mas o servidor poderá estar escutando e as chamadas RPC subsequentes poderão ser bem-sucedidas.

Comentários

Um aplicativo chama a função RpcMgmtIsServerListening para determinar se o servidor especificado no parâmetro Binding está escutando chamadas de procedimento remoto.

A função RpcMgmtIsServerListening retornará um valor de RPC_S_OK se o servidor tiver chamado RpcServerListen.

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

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

Confira também

RpcEpResolveBinding

RpcServerListen