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

get_IsRuleGroupCurrentlyEnabled 메서드는 지정된 방화벽 규칙 그룹을 현재 프로필에 대해 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 결정합니다.

구문

HRESULT get_IsRuleGroupCurrentlyEnabled(
  [in]  BSTR         group,
  [out] VARIANT_BOOL *enabled
);

매개 변수

[in] group

규칙을 그룹화하는 데 사용된 문자열입니다. "@C:\Program Files\Contoso Storefront\StorefrontRes.dll,-1234" 형식으로 그룹 이름 또는 그룹 이름에 대한 간접 문자열일 수 있습니다. 이 그룹에 속하는 규칙은 쿼리됩니다.

[out] enabled

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

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

Windows 7 이상의 경우 규칙 그룹이 하나 이상의 활성 프로필에서 사용하도록 설정된 경우 이 값은 true(VARIANT_TRUE)로 설정됩니다.

반환 값

C++

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

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

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

 

Windows 7 이상의 경우 여러 프로필이 활성 상태이고 프로필에 IsRuleGroupCurrentlyEnabled에 대한 답변이 다른 경우 반환 값은 S_FALSE. 프로필이 IsRuleGroupCurrentlyEnabled에 대해 동일한 대답을 갖는 경우 반환 값은 S_TRUE.

VB

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

설명

"@C:\Program Files\Contoso Storefront\StorefrontRes.dll,-1234" 형식의 간접 문자열이 고급 보안 API를 사용하여 Windows 방화벽에 매개 변수로 전달되는 경우 전체 경로로 지정해야 합니다. 파일에는 Windows 방화벽 서비스가 문자열을 읽을 수 있도록 로컬 서비스 계정 읽기 액세스를 허용하는 보안 액세스 권한이 있어야 합니다. 권한이 없는 보안 주체가 문자열을 수정하지 않도록 하려면 DLL에서 관리자 계정에 대한 쓰기 액세스만 허용해야 합니다.

요구 사항

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

추가 정보

INetFwPolicy2

규칙 작성