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

  • Статья

Извлекает сведения о сетевом подключении, даже если оно в настоящее время отключено.

Синтаксис

DWORD NPGetConnection3(
  [in]      LPCWSTR lpLocalName,
  [in]      DWORD   dwLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Параметры

[in] lpLocalName

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

[in] dwLevel

Значение, указывающее, подключено или отключено сетевое подключение.

Значение Значение
WNGETCON_CONNECTED
 Сетевое подключение подключено.
WNGETCON_DISCONNECTED
 Сетевое подключение отключено.

[out] lpBuffer

Указатель Void, получающий буфер, содержащий запрошенные сведения.

[in, out] lpBufferSize

Указатель на размер буфера lpBuffer (в символах). Если вызов завершается сбоем, так как буфер недостаточно велик, для lpBufferSize устанавливается требуемый размер буфера.

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

Если функция выполнена успешно, она должна вернуть WN_SUCCESS.

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

Код возврата Описание
WN_NOT_CONNECTED
 Устройство, указанное в параметре lpLocalName , не перенаправляется этим поставщиком.
WN_MORE_DATA
 Буфер был слишком мал для получения всех данных.
WN_NO_NETWORK
 Сеть отсутствует.

Комментарии

Сетевое подключение может существовать в трех состояниях: подключено, отключено и недоступно. Функция NPGetConnection3 не может получить сведения о сетевых подключениях, которые в настоящее время недоступны. Однако он может получить сведения о сетевых подключениях, которые в настоящее время отключены, так как Windows хранит сведения о подключении.

Требования

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