Compartir a través de

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

  • Artículo

El método RestrictService activa o desactiva la restricción de servicio para un servicio determinado.

Sintaxis

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

Parámetros

[in] serviceName

Nombre del servicio para el que se está activando o desactivando la restricción de servicio.

[in] appName

Nombre de la aplicación para la que se activa o desactiva la restricción de servicio.

[in] restrictService

Indica si la restricción de servicio está activada o desactivada. Si este valor es true (VARIANT_TRUE), el servicio se restringirá al enviar o recibir tráfico de red. La colección de reglas de protección de servicios de Windows puede contener reglas que pueden permitir el acceso de red entrante o saliente específico a este servicio según los requisitos específicos. Si es false (VARIANT_FALSE), el servicio no está restringido por la protección del servicio de Windows.

[in] serviceSidRestricted

Indica el tipo de SID de servicio para el servicio especificado. Si este valor es true (VARIANT_TRUE), el SID del servicio se restringirá. De lo contrario, no estará restringido.

Valor devuelto

C++

Si el método se ejecuta correctamente, el valor devuelto es S_OK.

Si se produce un error en el método, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto Descripción
E_ACCESSDENIED
 La operación se anuló debido a problemas de permisos.
E_INVALIDARG
 Error en el método debido a un parámetro no válido.
 

VB

Si el método se ejecuta correctamente, el valor devuelto es S_OK.

Si se produce un error en el método, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto Descripción
E_ACCESSDENIED
 La operación se anuló debido a problemas de permisos.
E_INVALIDARG
 Error en el método debido a un parámetro no válido.

Comentarios

Al agregar reglas, tenga en cuenta que puede haber un retraso de tiempo pequeño antes de aplicar la regla recién agregada.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado netfw.h
Archivo DLL FirewallAPI.dll

Consulte también

INetFwServiceRestriction