INetFwMgr::IsPortAllowed 메서드(netfw.h)

[Windows 방화벽 API는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. Windows Vista 이상에서는 고급 보안 API와 함께 Windows 방화벽 을 사용하는 것이 좋습니다.]

애플리케이션이 지정된 포트에서 인바운드 트래픽을 수신 대기할 수 있는지 여부를 결정합니다.

구문

HRESULT IsPortAllowed(
  [in]  BSTR               imageFileName,
  [in]  NET_FW_IP_VERSION  ipVersion,
  [in]  LONG               portNumber,
  [in]  BSTR               localAddress,
  [in]  NET_FW_IP_PROTOCOL ipProtocol,
  [out] VARIANT            *allowed,
  [out] VARIANT            *restricted
);

매개 변수

[in] imageFileName

네트워크에서 수신 대기하는 프로세스의 이미지 파일 이름입니다. 정규화된 경로여야 하지만 환경 변수가 포함될 수 있습니다. imageFileName이 NULL인 경우 함수는 포트가 모든 애플리케이션에 허용되는지 여부를 결정합니다.

[in] ipVersion

트래픽의 IP 버전입니다. localAddress가 NULL이 아닌 경우 NET_FW_IP_VERSION_ANY 않아야 합니다.

[in] portNumber

트래픽의 로컬 IP 포트 번호입니다.

[in] localAddress

점선 10진수 IPv4 주소 또는 트래픽의 로컬 주소를 지정하는 IPv6 16진수 주소입니다. 일반적으로 바인딩에 전달된 주소입니다. localAddress가 NULL인 경우 함수는 포트가 모든 인터페이스에 허용되는지 여부를 결정합니다.

[in] ipProtocol

NET_FW_IP_PROTOCOL_TCP 또는NET_FW_IP_PROTOCOL_UDP 트래픽의 IP 프로토콜입니다.

[out] allowed

포트가 일부 로컬 인터페이스 및 원격 주소에 허용되는지 여부를 VARIANT_TRUE 또는 VARIANT_FALSE 값으로 나타냅니다.

[out] restricted

이 포트에 대해 일부 로컬 인터페이스 또는 원격 주소가 차단되는지 여부를 VARIANT_TRUE 또는 VARIANT_FALSE 값으로 나타냅니다. 예를 들어 포트가 로컬 서브넷으로만 제한되는 경우입니다.

반환 값

C++

VB

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

설명

이 메서드 대신 INetFwPolicy2::IsRuleGroupEnabled 메서드를 사용하는 것이 좋습니다.

IsPortAllowed 메서드는 트래픽이 현재 방화벽 구성에서 허용되는지 여부를 확인합니다.

• 특정 애플리케이션.
• 특정 포트입니다.
• 특정 포트의 특정 애플리케이션입니다.

IsPortAllowed 작업에서 방화벽이 현재 사용 또는 비활성화되었는지 여부, 애플리케이션이 현재 프로필 예외 목록에서 허용되는지 여부, 현재 프로필 예외 목록에서 포트가 허용되는지 여부, 파일 및 인쇄 공유 옵션이 사용하도록 설정되었는지 여부 및 원격 관리 옵션이 활성화되었는지 여부를 고려합니다.

포트가 허용되는지 여부를 결정하는 많은 요인, 이 메서드의 입력 매개 변수를 통해 제공되는 보다 구체적인 정보 때문에 의미 있는 제한 사항이 있는 명확한 결과가 반환될 가능성이 높습니다.

요구 사항

추가 정보

INetFwMgr

NET_FW_IP_PROTOCOL

NET_FW_IP_VERSION