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

Метод INetConnection::GetProperties (netcon.h)

  • Статья

[Брандмауэр подключения к Интернету может быть изменен или недоступен в последующих версиях. Вместо этого используйте API брандмауэра Windows.]

Метод GetProperties извлекает структуру, содержащую свойства для этого сетевого подключения.

Синтаксис

HRESULT GetProperties(
  [out] NETCON_PROPERTIES **ppProps
);

Параметры

[out] ppProps

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

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

Если метод завершается успешно, возвращается значение S_OK.

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

Код возврата Описание
E_ABORT
 Операция была прервана.
E_FAIL
 Произошла неизвестная ошибка.
E_INVALIDARG
 Один из параметров недопустим.
E_NOINTERFACE
 Указанный интерфейс не поддерживается.
E_NOTIMPL
 Указанный метод не реализован.
E_OUTOFMEMORY
 Методу не удалось выделить необходимую память.
E_POINTER
 Недопустимый указатель, переданный в качестве параметра.
E_UNEXPECTED
 Сбой метода по неизвестным причинам.

Комментарии

Вызывающее приложение должно освободить память, занятую структурой NETCON_PROPERTIES , возвращаемой GetProperties. Освободите память, вызвав функцию NcFreeNetconProperties . Эта функция определена в NetCon.h и экспортируется NetShell.dll.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header netcon.h
DLL Hnetcfg.dll

См. также раздел

INetConnection

Интерфейсы брандмауэра для общего доступа к подключению к Интернету и подключения к Интернету

Справочник по брандмауэру для общего доступа к подключению к Интернету и подключений к Интернету