INetFwPolicy2::EnableRuleGroup 메서드(netfw.h)
EnableRuleGroup 메서드는 지정된 방화벽 규칙 그룹을 사용하거나 사용하지 않도록 설정합니다.
구문
HRESULT EnableRuleGroup(
[in] long profileTypesBitmask,
[in] BSTR group,
[in] VARIANT_BOOL enable
);
매개 변수
[in] profileTypesBitmask
NET_FW_PROFILE_TYPE2 프로필의 비트 마스크입니다.
[in] group
규칙을 그룹화하는 데 사용된 문자열입니다. "@C:\Program Files\Contoso Storefront\StorefrontRes.dll,-1234" 형식으로 그룹 이름 또는 그룹 이름에 대한 간접 문자열일 수 있습니다. 이 그룹에 속하는 규칙은 사용하거나 사용하지 않도록 설정됩니다.
[in] enable
그룹 매개 변수로 식별된 규칙 그룹을 사용하거나 사용하지 않도록 설정할지 여부를 나타냅니다.
이 값이 true(VARIANT_TRUE)로 설정되면 규칙 그룹이 사용하도록 설정됩니다. 그렇지 않으면 그룹이 비활성화됩니다.
반환 값
C++
메서드가 성공하면 반환 값이 S_OK.메서드가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 반환 코드 | Description |
|---|---|
|
권한 문제로 인해 작업이 중단되었습니다. |
|
잘못된 매개 변수로 인해 메서드가 실패했습니다. |
|
요청된 그룹이 없습니다. |
VB
메서드가 성공하면 반환 값이 S_OK.메서드가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 반환 코드 | Description |
|---|---|
|
권한 문제로 인해 작업이 중단되었습니다. |
|
잘못된 매개 변수로 인해 메서드가 실패했습니다. |
|
요청된 그룹이 없습니다. |
설명
"@C:\Program Files\Contoso Storefront\StorefrontRes.dll,-1234" 형식의 간접 문자열이 고급 보안 API를 사용하여 Windows 방화벽에 매개 변수로 전달되는 경우 전체 경로로 지정해야 합니다. 파일에는 Windows 방화벽 서비스가 문자열을 읽을 수 있도록 로컬 서비스 계정 읽기 액세스를 허용하는 보안 액세스 권한이 있어야 합니다. 권한이 없는 보안 주체가 문자열을 수정하지 않도록 하려면 DLL에서 관리자 계정에 대한 쓰기 액세스만 허용해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | netfw.h |
| DLL | FirewallAPI.dll |