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


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

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

Синтаксис

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

Параметры

[in] lpLocalName

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

[in] dwLevel

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

Ценность Meaning
WNGETCON_CONNECTED
Сетевое подключение подключено.
WNGETCON_DISCONNECTED
Сетевое подключение отключено.

[out] lpBuffer

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

[in, out] lpBufferSize

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

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

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

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

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

Замечания

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

Требования

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