INetFwServiceRestriction::RestrictService 메서드(netfw.h)

RestrictService 메서드는 지정된 서비스에 대한 서비스 제한을 설정하거나 해제합니다.

구문

HRESULT RestrictService(
  [in] BSTR         serviceName,
  [in] BSTR         appName,
  [in] VARIANT_BOOL restrictService,
  [in] VARIANT_BOOL serviceSidRestricted
);

매개 변수

[in] serviceName

서비스 제한을 설정하거나 해제하는 서비스의 이름입니다.

[in] appName

서비스 제한이 설정되거나 해제되는 애플리케이션의 이름입니다.

[in] restrictService

서비스 제한이 설정되어 있는지 여부를 나타냅니다. 이 값이 true(VARIANT_TRUE)이면 네트워크 트래픽을 보내거나 받을 때 서비스가 제한됩니다. Windows 서비스 강화 규칙 컬렉션에는 특정 요구 사항에 따라 이 서비스별 인바운드 또는 아웃바운드 네트워크 액세스를 허용할 수 있는 규칙이 포함될 수 있습니다. false(VARIANT_FALSE)이면 Windows 서비스 강화에 의해 서비스가 제한되지 않습니다.

[in] serviceSidRestricted

지정된 서비스의 서비스 SID 유형을 나타냅니다. 이 값이 true(VARIANT_TRUE)이면 서비스 SID가 제한됩니다. 그렇지 않으면 제한되지 않습니다.

반환 값

C++

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

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

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

 

VB

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

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

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

설명

규칙을 추가할 때 새로 추가된 규칙이 적용되기 전에 약간의 시간 지연이 있을 수 있습니다.

요구 사항

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

추가 정보

INetFwServiceRestriction