Función FwpmCalloutSetSecurityInfoByKey0 (fwpmu.h)
La función FwpmCalloutSetSecurityInfoByKey0 establece la información de seguridad especificada en el descriptor de seguridad de un objeto de llamada.
Sintaxis
DWORD FwpmCalloutSetSecurityInfoByKey0(
[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*
Puntero a un GUID que identifica de forma única la llamada. Este GUID se especificó en el miembro calloutKey del parámetro callout cuando la aplicación llamó a FwpmCalloutAdd0 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*
La 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 llamadas.
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 Estándar SetSecurityInfo de Win32. El autor de la llamada necesita los mismos derechos de acceso estándar que se describen en el tema de referencia SetSecurityInfo .
FwpmCalloutSetSecurityInfoByKey0 es una implementación específica de FwpmCalloutSetSecurityInfoByKey. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.
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 |