Función FwpmLayerSetSecurityInfoByKey0 (fwpmu.h)
La función FwpmLayerSetSecurityInfoByKey0 establece la información de seguridad especificada en el descriptor de seguridad de un objeto de capa.
Sintaxis
DWORD FwpmLayerSetSecurityInfoByKey0(
[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 de la capa. Consulte Filtering Layer Identifiers (Filtrado de identificadores de capa ) para obtener una lista de posibles valores GUID.
[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 |
|---|---|
|
El descriptor de seguridad se estableció correctamente. |
|
Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información. |
|
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 capas.
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.
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 .
FwpmLayerSetSecurityInfoByKey0 es una implementación específica de FwpmLayerSetSecurityInfoByKey. Para obtener más información, consulte NOMBRES de PMA Version-Independent y versiones específicas de destino de Windows .
Requisitos
| 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 |