Поделиться через

Функция RpcMgmtInqStats (rpcdce.h)

  • Статья

Функция RpcMgmtInqStats возвращает статистику выполнения RPC.

Синтаксис

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

Параметры

Binding

Чтобы получить статистику по удаленному приложению, укажите для этого приложения дескриптор привязки сервера. Чтобы получить статистику по собственному (локальному) приложению, укажите значение NULL.

Statistics

Возвращает указатель на указатель на статистику о сервере, заданном параметром Binding . Каждая статистика представляет собой длинное значение без знака .

Возвращаемое значение

Значение Значение
RPC_S_OK
 Вызов выполнен успешно.
RPC_S_INVALID_BINDING
 Недопустимый дескриптор привязки.
RPC_S_WRONG_KIND_OF_BINDING
 Это была неправильная привязка для операции.
 
Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.
 

Комментарии

Приложение вызывает функцию RpcMgmtInqStats для получения статистики по указанному серверу из библиотеки времени выполнения RPC.

Каждый элемент массива в возвращаемом векторе статистики содержит длинное значение без знака . В следующей таблице описана статистика, индексированная указанной константой.

Статистика Описание
RPC_C_STATS_CALLS_IN Количество вызовов удаленных процедур, полученных сервером RPC, заданным дескриптором привязки.
RPC_C_STATS_CALLS_OUT Число удаленных вызовов процедур, инициированных сервером RPC, указанным дескриптором привязки.
RPC_C_STATS_PKTS_IN Число сетевых пакетов, полученных сервером RPC, заданным дескриптором привязки.
RPC_C_STATS_PKTS_OUT Число сетевых пакетов, отправленных сервером RPC, заданным дескриптором привязки.
 
 

Библиотека времени выполнения RPC выделяет память для вектора статистики. Приложение отвечает за вызов функции RpcMgmtStatsVectorFree для освобождения памяти, используемой вектором статистики.

Для успешного выполнения этой функции сервер должен прослушивать удаленные вызовы процедур. Если сервер не прослушивает, функция завершается сбоем.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header rpcdce.h (включая Rpc.h)
Библиотека Rpcrt4.lib
DLL Rpcrt4.dll

См. также раздел

RpcEpResolveBinding

RpcMgmtStatsVectorFree