Fonction RpcMgmtInqStats (rpcdce.h)

Article
03/04/2024

La fonction RpcMgmtInqStats retourne des statistiques d’exécution RPC.

Syntaxe

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

Paramètres

Binding

Pour recevoir des statistiques sur une application distante, spécifiez un handle de liaison de serveur pour cette application. Pour recevoir des statistiques sur votre propre application (locale), spécifiez la valeur NULL.

Statistics

Retourne un pointeur vers un pointeur vers les statistiques sur le serveur spécifiées par le paramètre Binding . Chaque statistique est une valeur longue non signée .

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_BINDING	Le handle de liaison n’était pas valide.
RPC_S_WRONG_KIND_OF_BINDING	Il s’agissait du mauvais type de liaison pour l’opération.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

Remarques

Une application appelle la fonction RpcMgmtInqStats pour obtenir des statistiques sur le serveur spécifié à partir de la bibliothèque d’exécution RPC.

Chaque élément de tableau dans le vecteur de statistiques retourné contient une valeur longue non signée . Le tableau suivant décrit les statistiques indexées par la constante spécifiée.

Statistique	Description
RPC_C_STATS_CALLS_IN	Nombre d’appels de procédure distante reçus par le serveur RPC spécifié par le handle de liaison.
RPC_C_STATS_CALLS_OUT	Nombre d’appels de procédure distante lancés par le serveur RPC spécifié par le handle de liaison.
RPC_C_STATS_PKTS_IN	Nombre de paquets réseau reçus par le serveur RPC spécifié par le handle de liaison.
RPC_C_STATS_PKTS_OUT	Nombre de paquets réseau envoyés par le serveur RPC spécifié par le handle de liaison.

La bibliothèque d’exécution RPC alloue de la mémoire pour le vecteur de statistiques. L’application est chargée d’appeler la fonction RpcMgmtStatsVectorFree pour libérer la mémoire utilisée par le vecteur de statistiques.

Le serveur doit être à l’écoute des appels de procédure distante pour que cette fonction réussisse. Si le serveur n’écoute pas, la fonction échoue.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	rpcdce.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll

Voir aussi

RpcEpResolveBinding

RpcMgmtStatsVectorFree

Partager via