Функция 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. В противном случае он должен возвращать код ошибки, который может быть одним из следующих:

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

Замечания

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

Требования

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