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

  • Статья

Извлекает сведения о подключении.

Синтаксис

DWORD NPGetConnection(
  [in]      LPWSTR  lpLocalName,
  [out]     LPWSTR  lpRemoteName,
  [in, out] LPDWORD lpnBufferLen
);

Параметры

[in] lpLocalName

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

[out] lpRemoteName

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

[in, out] lpnBufferLen

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

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

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

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

Комментарии

Функция NPGetConnection может возвращать сведения только о сетевом подключении, которое подключено в данный момент. Чтобы получить сведения о сетевом подключении, которое в настоящее время отключено, используйте NPGetConnection3.

Требования

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