INetFwPolicy2::IsRuleGroupEnabled 메서드(netfw.h)

IsRuleGroupEnabled 메서드는 지정된 방화벽 규칙 그룹을 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 결정합니다.

구문

HRESULT IsRuleGroupEnabled(
  [in]  long         profileTypesBitmask,
  [in]  BSTR         group,
  [out] VARIANT_BOOL *enabled
);

매개 변수

[in] profileTypesBitmask

NET_FW_PROFILE_TYPE2 프로필의 비트 마스크입니다.

[in] group

규칙을 함께 그룹화하는 데 사용된 문자열입니다. 그룹 이름 또는 "@yourresourcedll.dll,-23255" 형식의 그룹 이름에 대한 간접 문자열일 수 있습니다. 이 그룹에 속하는 규칙은 쿼리됩니다.

[out] enabled

그룹 매개 변수로 식별된 규칙 그룹을 사용할 수 있는지 여부를 나타냅니다.

이 값을 true(VARIANT_TRUE)로 설정하면 규칙 그룹이 활성화됩니다. 그렇지 않으면 그룹이 비활성화됩니다.

반환 값

C++

메서드가 성공하면 반환 값이 S_OK.

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

반환 코드	설명
ACCESSDENIED	권한 문제로 인해 작업이 중단되었습니다.
E_INVALIDARG	잘못된 매개 변수로 인해 메서드가 실패했습니다.
E_POINTER	포인터가 잘못되어 메서드가 실패했습니다.
S_FALSE	요청된 그룹이 없습니다.

 

VB

이 호출은 그룹 매개 변수로 식별된 규칙 그룹을 사용할 수 있는지 여부를 나타내는 부울 사용 상태 반환합니다. 이 값을 true(VARIANT_TRUE)로 설정하면 규칙 그룹이 활성화됩니다. 그렇지 않으면 그룹이 비활성화됩니다.

설명

"@yourresourcedll.dll,-23255" 형식의 간접 문자열이 고급 보안 API를 사용하여 Windows 방화벽에 매개 변수로 전달되는 경우 System32 Windows 디렉터리 아래에 배치하거나 전체 경로로 지정해야 합니다. 또한 파일에는 Windows 방화벽 서비스가 문자열을 읽을 수 있도록 로컬 서비스 계정 읽기 액세스를 허용하는 보안 액세스 권한이 있어야 합니다. 권한이 없는 보안 주체가 문자열을 수정하지 않도록 하려면 DLL에서 관리자 계정에 대한 쓰기 액세스만 허용해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	netfw.h
DLL	FirewallAPI.dll

추가 정보

INetFwPolicy2