INetFwRule 인터페이스(netfw.h)
INetFwRule 인터페이스는 규칙의 속성에 대한 액세스를 제공합니다.
상속
INetFwRule 인터페이스는 IDispatch 인터페이스에서 상속됩니다. INetFwRule 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
INetFwRule 인터페이스에는 이러한 메서드가 있습니다.
| INetFwRule::get_Action 규칙 또는 기본 설정에 대한 작업을 지정합니다. (INetFwRule.get_Action) |
| INetFwRule::get_ApplicationName 이 규칙이 적용되는 애플리케이션의 이름을 지정합니다. (Get) |
| INetFwRule::get_Description 이 규칙에 대한 설명을 지정합니다. (Get) |
| INetFwRule::get_Direction 규칙이 적용되는 트래픽의 방향을 지정합니다. (Get) |
| INetFwRule::get_EdgeTraversal 이 규칙에 대해 에지 순회를 사용할지 여부를 나타냅니다. (Get) |
| INetFwRule::get_Enabled 규칙을 사용하거나 사용하지 않도록 설정합니다. (Get) |
| INetFwRule::get_Grouping 개별 규칙이 속한 그룹을 지정합니다. (Get) |
| INetFwRule::get_IcmpTypesAndCodes 이 규칙에 대한 ICMP 형식 및 코드 목록을 지정합니다. (Get) |
| INetFwRule::get_Interfaces 규칙이 적용되는 인터페이스 목록을 지정합니다. (Get) |
| INetFwRule::get_InterfaceTypes 규칙이 적용되는 인터페이스 형식 목록을 지정합니다. (Get) |
| INetFwRule::get_LocalAddresses 이 규칙의 로컬 주소 목록을 지정합니다. (Get) |
| INetFwRule::get_LocalPorts 이 규칙의 로컬 포트 목록을 지정합니다. (Get) |
| INetFwRule::get_Name 이 규칙의 이름을 지정합니다. (Get) |
| INetFwRule::get_Profiles 규칙이 속한 프로필을 지정합니다. (Get) |
| INetFwRule::get_Protocol 이 규칙의 IP 프로토콜을 지정합니다. (Get) |
| INetFwRule::get_RemoteAddresses 이 규칙의 원격 주소 목록을 지정합니다. (Get) |
| INetFwRule::get_RemotePorts 이 규칙에 대한 원격 포트 목록을 지정합니다. (Get) |
| INetFwRule::get_ServiceName 애플리케이션의 서비스 이름 속성을 지정합니다. (Get) |
| INetFwRule::p ut_Action 규칙 또는 기본 설정에 대한 작업을 지정합니다. (INetFwRule.put_Action) |
| INetFwRule::p ut_ApplicationName 이 규칙이 적용되는 애플리케이션의 이름을 지정합니다. (Put) |
| INetFwRule::p ut_Description 이 규칙에 대한 설명을 지정합니다. (Put) |
| INetFwRule::p ut_Direction 규칙이 적용되는 트래픽의 방향을 지정합니다. (Put) |
| INetFwRule::p ut_EdgeTraversal 이 규칙에 대해 에지 순회를 사용할지 여부를 나타냅니다. (Put) |
| INetFwRule::p ut_Enabled 규칙을 사용하거나 사용하지 않도록 설정합니다. (Put) |
| INetFwRule::p ut_Grouping 개별 규칙이 속한 그룹을 지정합니다. (Put) |
| INetFwRule::p ut_IcmpTypesAndCodes 이 규칙에 대한 ICMP 형식 및 코드 목록을 지정합니다. (Put) |
| INetFwRule::p ut_Interfaces 규칙이 적용되는 인터페이스 목록을 지정합니다. (Put) |
| INetFwRule::p ut_InterfaceTypes 규칙이 적용되는 인터페이스 형식 목록을 지정합니다. (Put) |
| INetFwRule::p ut_LocalAddresses 이 규칙의 로컬 주소 목록을 지정합니다. (Put) |
| INetFwRule::p ut_LocalPorts 이 규칙의 로컬 포트 목록을 지정합니다. (Put) |
| INetFwRule::p ut_Name 이 규칙의 이름을 지정합니다. (Put) |
| INetFwRule::p ut_Profiles 규칙이 속한 프로필을 지정합니다. (Put) |
| INetFwRule::p ut_Protocol 이 규칙의 IP 프로토콜을 지정합니다. (Put) |
| INetFwRule::p ut_RemoteAddresses 이 규칙의 원격 주소 목록을 지정합니다. (Put) |
| INetFwRule::p ut_RemotePorts 이 규칙에 대한 원격 포트 목록을 지정합니다. (Put) |
| INetFwRule::p ut_ServiceName 애플리케이션의 서비스 이름 속성을 지정합니다. (Put) |
설명
규칙의 속성을 변경할 때마다 Windows 방화벽은 규칙을 커밋하고 정확성을 확인합니다. 따라서 규칙을 편집할 때 특정 순서로 단계를 수행해야 합니다. 예를 들어 ICMP 규칙을 추가하는 경우 먼저 프로토콜을 ICMP로 설정한 다음, 규칙을 추가해야 합니다. 이러한 단계를 반대 순서로 수행하면 오류가 발생하고 변경 내용이 손실됩니다.
TCP 포트 규칙을 편집하고 ICMP 규칙으로 변환하는 경우 먼저 포트를 삭제하고 TCP에서 ICMP로 프로토콜을 변경한 다음 규칙을 추가합니다.
기존 규칙을 검색하고 수정하려면 INetFwRules를 통해 이 인터페이스의 인스턴스를 검색해야 합니다. 모든 구성 변경은 즉시 수행됩니다.
규칙의 속성에 액세스할 때 새로 추가된 규칙이 적용되기 전에 약간의 시간 지연이 있을 수 있습니다.
속성은 방화벽 규칙을 만드는 데 사용됩니다. 많은 속성을 사용하여 매우 구체적인 방화벽 규칙을 만들 수 있습니다.
| 속성 | 형식 및 형식 | 제약 조건 |
|---|---|---|
| 이름 | 텍스트 문자열 지우기. | 필수 사항입니다. 문자열에 "|"가 포함되어서는 안 되며 "all"이 아니어야 합니다. |
| 설명 | 텍스트 문자열 지우기. | 선택 사항입니다. 문자열에 "|"가 포함되어서는 안 됩니다. |
| 그룹화 | "@<dll 이름>, <리소스 문자열 식별자" 형식의 문자열입니다>. | 필수 사항입니다. |
| Enabled | 부울(VARIANT_BOOLEAN). | 선택 사항입니다. 아무것도 지정하지 않으면 기본값은 false(VARIANT_FALSE)입니다. |
| ApplicationName | 텍스트 문자열 지우기. | 선택 사항입니다. |
| ServiceName | 텍스트 문자열 지우기. | 선택 사항입니다. |
| LocalPorts | 포트 번호 목록을 포함하는 텍스트 문자열을 지웁니다. "RPC"는 허용되는 값입니다. | 선택 사항입니다. |
| RemotePorts | 포트 번호 목록을 포함하는 텍스트 문자열을 지웁니다. | 선택 사항입니다. |
| LocalAddresses | 쉼표로 구분된 IPv4 및 IPv6 주소 목록을 포함하는 텍스트 문자열을 지웁니다. 범위 값 및"*"은 이 목록에서 허용됩니다. | 선택 사항입니다. |
| RemoteAddresses | 쉼표로 구분된 IPv4 및 IPv6 주소 목록을 포함하는 텍스트 문자열을 지웁니다. 범위 값 및"*"은 이 목록에서 허용됩니다. | 선택 사항입니다. |
| 프로토콜 | 숫자. | 선택 사항입니다. |
| put_Profiles | "type, code" 형식의 문자열 값입니다. 각 쌍을 ";"로 구분하여 문자열에 여러 형식과 코드를 포함할 수 있습니다. | 선택 사항입니다. |
| 인터페이스 | 인터페이스의 이름을 포함하는 문자열의 배열입니다. | 선택 사항입니다. |
| InterfaceTypes | 문자열 값입니다. 각 값을 ""로 구분하여 문자열에 여러 인터페이스 형식을 포함할 수 있습니다. 허용되는 값은 "RemoteAccess", "Wireless", "Lan" 및 "All"입니다. | 선택 사항입니다. |
| 방향 | 열거형입니다. | 선택 사항입니다. |
| 동작 | 열거형입니다. | 선택 사항입니다. |
| EdgeTraversal | 부울(VARIANT_BOOLEAN). | 선택 사항입니다. |
| 프로필 | 열거형입니다. | 선택 사항입니다. |
각 속성에 대한 자세한 내용은 해당 항목을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | netfw.h |