Функция NPGetConnectionPerformance (npapi.h)

  • Статья

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

Синтаксис

DWORD NPGetConnectionPerformance(
  [in]  LPCWSTR                lpRemoteName,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);

Параметры

[in] lpRemoteName

Указатель на локальное или удаленное имя подключенного ресурса.

[out] lpNetConnectInfo

Указатель на структуру NETCONNECTINFOSTRUCT , которая заполняется поставщиком сети, если у поставщика есть подключение к сетевому ресурсу. Все остальные поля этой структуры, кроме поля cbStructure , заполняются нулями, прежде чем MPR передает запрос поставщикам сети. В результате поставщик должен выполнять запись только в поля, для которых у него есть доступная информация. Кроме того, для значений скорости значение 1 означает, что производительность выше, чем может быть представлена в единице измерения.

Возвращаемые сведения могут быть оценочной. Если сети не удается получить сведения о ресурсе в сети, она может вернуть сведения о сетевом адаптере и связанной с ним производительности, а затем задать соответствующее поле dwFlags .

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

Если функция выполнена успешно, она должна вернуть WN_SUCCESS. В противном случае он должен вернуть код ошибки, который может быть одним из следующих.

Код возврата Описание
WN_NOT_CONNECTED
 lpRemoteName не является подключенным сетевым ресурсом.
WN_NO_NETWORK
 Сеть отсутствует.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header npapi.h