Compartir a través de

Función IPsecDospGetSecurityInfo0 (fwpmu.h)

  • Artículo

La función IPsecDospGetSecurityInfo0 recupera una copia del descriptor de seguridad de la base de datos de protección doS de IPsec.

Sintaxis

DWORD IPsecDospGetSecurityInfo0(
  [in]            HANDLE               engineHandle,
  [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] 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

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 .

IPsecDospGetSecurityInfo0 es una implementación específica de IPsecDospGetSecurityInfo. 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 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fwpmu.h
Library Fwpuclnt.lib
Archivo DLL Fwpuclnt.dll

Consulte también

IPsecDospSetSecurityInfo0