Função RpcMgmtInqStats (rpcdce.h)

  • Artigo

A função RpcMgmtInqStats retorna estatísticas de tempo de execução RPC.

Sintaxe

RPC_STATUS RpcMgmtInqStats(
  RPC_BINDING_HANDLE Binding,
  RPC_STATS_VECTOR   **Statistics
);

Parâmetros

Binding

Para receber estatísticas sobre um aplicativo remoto, especifique um identificador de associação de servidor para esse aplicativo. Para receber estatísticas sobre seu próprio aplicativo (local), especifique um valor nulo.

Statistics

Retorna um ponteiro para um ponteiro para as estatísticas sobre o servidor especificado pelo parâmetro Binding . Cada estatística é um valor longo sem sinal .

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 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.
 

Comentários

Um aplicativo chama a função RpcMgmtInqStats para obter estatísticas sobre o servidor especificado da biblioteca de tempo de execução RPC.

Cada elemento de matriz no vetor de estatísticas retornado contém um valor longo sem sinal . A tabela a seguir descreve as estatísticas indexadas pela constante especificada.

Estatística Descrição
RPC_C_STATS_CALLS_IN Número de chamadas de procedimento remoto recebidas pelo servidor RPC especificado pelo identificador de associação.
RPC_C_STATS_CALLS_OUT Número de chamadas de procedimento remoto iniciadas pelo servidor RPC especificado pelo identificador de associação.
RPC_C_STATS_PKTS_IN Número de pacotes de rede recebidos pelo servidor RPC especificado pelo identificador de associação.
RPC_C_STATS_PKTS_OUT Número de pacotes de rede enviados pelo servidor RPC especificado pelo identificador de associação.
 
 

A biblioteca de tempo de execução RPC aloca memória para o vetor de estatísticas. O aplicativo é responsável por chamar a função RpcMgmtStatsVectorFree para liberar a memória usada pelo vetor de estatísticas.

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

RpcMgmtStatsVectorFree