Compartilhar via

Método INetFwServiceRestriction::RestrictService (netfw.h)

  • Artigo

O método RestrictService ativa ou desativa a restrição de serviço para um determinado serviço.

Sintaxe

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

Parâmetros

[in] serviceName

Nome do serviço para o qual a restrição de serviço está sendo ativada ou desativada.

[in] appName

Nome do aplicativo para o qual a restrição de serviço está sendo ativada ou desativada.

[in] restrictService

Indica se a restrição de serviço está sendo ativada ou desativada. Se esse valor for true (VARIANT_TRUE), o serviço será restrito ao enviar ou receber tráfego de rede. A coleção de regras de Proteção de Serviço do Windows pode conter regras que podem permitir esse serviço acesso à rede de entrada ou saída específico por requisitos específicos. Se for falso (VARIANT_FALSE), o serviço não será restrito pela Proteção do Serviço Windows.

[in] serviceSidRestricted

Indica o tipo de SID de serviço para o serviço especificado. Se esse valor for true (VARIANT_TRUE), o SID do serviço será restrito. Caso contrário, ele será irrestrito.

Retornar valor

C++

Se o método tiver êxito, o valor retornado será S_OK.

Se o método falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
E_ACCESSDENIED
 A operação foi anulada devido a problemas de permissões.
E_INVALIDARG
 O método falhou devido a um parâmetro inválido.
 

VB

Se o método tiver êxito, o valor retornado será S_OK.

Se o método falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
E_ACCESSDENIED
 A operação foi anulada devido a problemas de permissões.
E_INVALIDARG
 O método falhou devido a um parâmetro inválido.

Comentários

Ao adicionar regras, observe que pode haver um pequeno atraso de tempo antes que a regra recém-adicionada seja aplicada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho netfw.h
DLL FirewallAPI.dll

Confira também

INetFwServiceRestriction