Метод INetSharingConfiguration::AddPortMapping (netcon.h)
[Брандмауэр подключения к Интернету может быть изменен или недоступен в последующих версиях. Вместо этого используйте API брандмауэра Windows.]
Метод AddPortMapping добавляет сопоставление портов службы для этого подключения.
Синтаксис
HRESULT AddPortMapping(
[in] BSTR bstrName,
[in] UCHAR ucIPProtocol,
[in] USHORT usExternalPort,
[in] USHORT usInternalPort,
[in] DWORD dwOptions,
[in] BSTR bstrTargetNameOrIPAddress,
[in] ICS_TARGETTYPE eTargetType,
[out] INetSharingPortMapping **ppMapping
);
Параметры
[in] bstrName
Указатель на переменную BSTR , содержащую имя для этого сопоставления портов.
[in] ucIPProtocol
Указывает IP-протокол, который необходимо задать для сопоставления портов. Протокол IP имеет одно из следующих значений:
NAT_PROTOCOL_TCP
NAT_PROTOCOL_UDP
[in] usExternalPort
Указывает внешний порт для этого сопоставления портов.
[in] usInternalPort
Указывает внутренний порт для этого сопоставления портов.
[in] dwOptions
Этот параметр зарезервирован и в настоящее время не используется.
[in] bstrTargetNameOrIPAddress
Указатель на переменную BSTR , содержащую имя целевого компьютера для этого сопоставления портов. Укажите имя целевого объекта или IP-адрес, но не оба.
[in] eTargetType
Указывает тип целевого объекта.
[out] ppMapping
Указатель на указатель, который при успешном возвращении указывает на интерфейс INetSharingPortMapping для сопоставления портов.
Возвращаемое значение
Если метод завершается успешно, возвращается значение S_OK.
Если метод завершается ошибкой, возвращается один из следующих кодов ошибок.
| Код возврата | Описание |
|---|---|
|
Операция была прервана. |
|
Произошла неизвестная ошибка. |
|
Один из параметров является недопустимым. |
|
Указанный интерфейс не поддерживается. |
|
Указанный метод не реализован. |
|
Методу не удалось выделить необходимую память. |
|
Недопустимый указатель, переданный в качестве параметра. |
|
Сбой метода по неизвестным причинам. |
Комментарии
При первом добавлении новое сопоставление находится в отключенном состоянии. Чтобы включить новое сопоставление, используйте INetSharingPortMapping::Enable.
После добавления новое определение появится в списке Сопоставления портов в пользовательском интерфейсе ICS/ICF.
Используйте метод INetSharingManager::get_INetSharingConfigurationForINetConnection , чтобы получить интерфейс INetSharingConfiguration для определенного подключения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | netcon.h |
| DLL | Hnetcfg.dll |
См. также раздел
Интерфейсы брандмауэра подключения к Интернету и общего доступа к Интернету