Función FwpmCalloutGetSecurityInfoByKey0 (fwpmu.h)

La función FwpmCalloutGetSecurityInfoByKey0 recupera una copia del descriptor de seguridad de un objeto de llamada.

Sintaxis

DWORD FwpmCalloutGetSecurityInfoByKey0(
  [in]            HANDLE               engineHandle,
  [in, optional]  const GUID           *key,
  [in]            SECURITY_INFORMATION securityInfo,
  [out, optional] PSID                 *sidOwner,
  [out, optional] PSID                 *sidGroup,
  [out, optional] PACL                 *dacl,
  [out, optional] PACL                 *sacl,
  [out]           PSECURITY_DESCRIPTOR *securityDescriptor
);

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 recuperar.

[out, optional] sidOwner

Tipo: PSID*

Identificador de seguridad del propietario (SID) en el descriptor de seguridad devuelto.

[out, optional] sidGroup

Tipo: PSID*

Identificador de seguridad del grupo principal (SID) en el descriptor de seguridad devuelto.

[out, optional] dacl

Tipo: PACL*

Lista de control de acceso discrecional (DACL) en el descriptor de seguridad devuelto.

[out, optional] sacl

Tipo: PACL*

Lista de control de acceso del sistema (SACL) en el descriptor de seguridad devuelto.

[out] securityDescriptor

Tipo: PSECURITY_DESCRIPTOR*

Descriptor de seguridad devuelto.

Valor devuelto

Tipo: DWORD

Código o valor devuelto	Descripción
ERROR_SUCCESS 0	El descriptor de seguridad se recuperó 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 llamadas.

El parámetro securityDescriptor devuelto debe liberarse a través de una llamada a FwpmFreeMemory0. Los otros cuatro parámetros devueltos (opcionales) no deben liberarse, ya que apuntan a direcciones dentro del parámetro securityDescriptor .

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

FwpmCalloutGetSecurityInfoByKey0 es una implementación específica de FwpmCalloutGetSecurityInfoByKey. 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

FwpmCalloutSetSecurityInfoByKey0