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

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

Синтаксис

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

Параметры

[in] lpRemoteName

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

[out] lpNetConnectInfo

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

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

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

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

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

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
Header	npapi.h
Library	nanosrv.lib