Funzione RpcMgmtInqStats (rpcdce.h)

Articolo
08/25/2023

La funzione RpcMgmtInqStats restituisce statistiche di runtime RPC.

Sintassi

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

Parametri

Binding

Per ricevere statistiche su un'applicazione remota, specificare un handle di associazione server per tale applicazione. Per ricevere statistiche relative all'applicazione (locale), specificare un valore NULL.

Statistics

Restituisce un puntatore a un puntatore alle statistiche sul server specificato dal parametro Binding . Ogni statistica è un valore long senza segno .

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_BINDING	L'handle di associazione non è valido.
RPC_S_WRONG_KIND_OF_BINDING	Questo è stato il tipo di associazione sbagliato per l'operazione.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

Un'applicazione chiama la funzione RpcMgmtInqStats per ottenere statistiche sul server specificato dalla libreria di runtime RPC.

Ogni elemento della matrice nel vettore di statistiche restituito contiene un valore long senza segno . Nella tabella seguente vengono descritte le statistiche indicizzate dalla costante specificata.

Statistiche	Descrizione
RPC_C_STATS_CALLS_IN	Numero di chiamate di routine remote ricevute dal server RPC specificato dall'handle di associazione.
RPC_C_STATS_CALLS_OUT	Numero di chiamate di routine remote avviate dal server RPC specificato dall'handle di associazione.
RPC_C_STATS_PKTS_IN	Numero di pacchetti di rete ricevuti dal server RPC specificato dall'handle di associazione.
RPC_C_STATS_PKTS_OUT	Numero di pacchetti di rete inviati dal server RPC specificato dall'handle di associazione.

La libreria di runtime RPC alloca la memoria per il vettore di statistiche. L'applicazione è responsabile della chiamata alla funzione RpcMgmtStatsVectorFree per rilasciare la memoria utilizzata dal vettore di statistiche.

Il server deve essere in ascolto delle chiamate di routine remote per la riuscita di questa funzione. Se il server non è in ascolto, la funzione ha esito negativo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll

Vedi anche

RpcEpResolveBinding

RpcMgmtStatsVectorFree

Condividi tramite