Función FwpmProviderSetSecurityInfoByKey0 (fwpmu.h)

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

Sintaxis

DWORD FwpmProviderSetSecurityInfoByKey0(
  [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 proveedor. Este es el mismo GUID que se especificó cuando la aplicación llamó a FwpmProviderAdd0 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
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 proveedores.

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 .

FwpmProviderSetSecurityInfoByKey0 es una implementación específica de FwpmProviderSetSecurityInfoByKey. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.

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

FwpmProviderGetSecurityInfoByKey0