Función FwpmFilterSetSecurityInfoByKey0 (fwpmu.h)

La función FwpmFilterSetSecurityInfoByKey0 establece la información de seguridad especificada en el descriptor de seguridad de un objeto de filtro.

Sintaxis

DWORD FwpmFilterSetSecurityInfoByKey0(
  [in]           HANDLE               engineHandle,
  [in, optional] const GUID           *key,
  [in]           SECURITY_INFORMATION securityInfo,
  [in, optional] const SID            *sidOwner,
  [in, optional] const SID            *sidGroup,
  [in, optional] const ACL            *dacl,
  [in, optional] const ACL            *sacl
);

Parámetros

[in] engineHandle

Tipo: HANDLE

Identificador de una sesión abierta en el motor de filtro. Llame a FwpmEngineOpen0 para abrir una sesión en el motor de filtro.

[in, optional] key

Tipo: GUID const*

Identificador único del filtro. Este GUID se especificó en el miembro filterKey del parámetro filter cuando la aplicación llamada FwpmFilterAdd0 para este objeto.

[in] securityInfo

Tipo: SECURITY_INFORMATION

Tipo de información de seguridad que se va a establecer.

[in, optional] sidOwner

Tipo: const SID*

Identificador de seguridad (SID) del propietario que se va a establecer en el descriptor de seguridad.

[in, optional] sidGroup

Tipo: const SID*

El SID del grupo que se va a establecer en el descriptor de seguridad.

[in, optional] dacl

Tipo: const ACL*

Lista de control de acceso discrecional (DACL) que se va a establecer en el descriptor de seguridad.

[in, optional] sacl

Tipo: const ACL*

Lista de control de acceso del sistema (SACL) que se va a establecer en el descriptor de seguridad.

Valor devuelto

Tipo: DWORD

Código o valor devuelto	Descripción
ERROR_SUCCESS 0	El descriptor de seguridad se estableció correctamente.
código de error FWP_E_* 0x80320001: 0x80320039	Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información.
RPC_* código de error* 0x80010001: 0x80010122	Error al comunicarse con el motor de firewall remoto o local.

Comentarios

Si el parámetro de clave es NULL o si es un GUID NULL , esta función administra la información de seguridad del contenedor de filtros.

No se puede llamar a esta función desde dentro de una transacción. Se producirá un error con FWP_E_TXN_IN_PROGRESS. Consulte Administración de objetos para obtener más información sobre las transacciones.

Se puede llamar a esta función dentro de una sesión dinámica si el objeto correspondiente se agregó durante la misma sesión. Si se llama a esta función para un objeto que se agregó durante una sesión dinámica diferente, se producirá un error con FWP_E_WRONG_SESSION. Si se llama a esta función para un objeto que no se agregó durante una sesión dinámica, se producirá un error con FWP_E_DYNAMIC_SESSION_IN_PROGRESS.

Esta función se comporta como la función SetSecurityInfo estándar de Win32. El llamador necesita los mismos derechos de acceso estándar que se describen en el tema de referencia SetSecurityInfo .

FwpmFilterSetSecurityInfoByKey0 es una implementación específica de FwpmFilterSetSecurityInfoByKey. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .

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	fwpmu.h
Library	Fwpuclnt.lib
Archivo DLL	Fwpuclnt.dll

Consulte también

FwpmFilterGetSecurityInfoByKey0