다음을 통해 공유

INetSharingConfiguration::AddPortMapping 메서드(netcon.h)

  • 아티클

[인터넷 연결 방화벽은 후속 버전에서 변경되거나 사용할 수 없습니다. 대신 Windows 방화벽 API를 사용합니다.]

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.

메서드가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

반환 코드 설명
E_ABORT
 작업이 중단되었습니다.
E_FAIL
 지정되지 않은 오류가 발생했습니다.
E_INVALIDARG
 매개 변수 중 하나가 잘못되었습니다.
E_NOINTERFACE
 지정된 인터페이스는 지원되지 않습니다.
E_NOTIMPL
 지정된 메서드가 구현되지 않았습니다.
E_OUTOFMEMORY
 메서드가 필요한 메모리를 할당할 수 없습니다.
E_POINTER
 매개 변수로 전달된 포인터가 잘못되었습니다.
E_UNEXPECTED
 알 수 없는 이유로 메서드가 실패했습니다.

설명

처음 추가되면 새 매핑이 비활성화된 상태입니다. 새 매핑을 사용하도록 설정하려면 INetSharingPortMapping::Enable을 사용합니다.

추가된 후 ICS/ICF 사용자 인터페이스의 포트 매핑 목록에 새 정의가 나타납니다.

INetSharingManager::get_INetSharingConfigurationForINetConnection 메서드를 사용하여 특정 연결에 대한 INetSharingConfiguration 인터페이스를 가져옵니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 netcon.h
DLL Hnetcfg.dll

추가 정보

INetSharingConfiguration

인터넷 연결 공유 및 인터넷 연결 방화벽 인터페이스

인터넷 연결 공유 및 인터넷 연결 방화벽 참조