Compartir a través de

Función FwpmvSwitchEventsGetSecurityInfo0 (fwpmu.h)

  • Artículo

La función FwpmvSwitchEventsGetSecurityInfo0 recupera una copia del descriptor de seguridad para un evento vSwitch.

Sintaxis

DWORD FwpmvSwitchEventsGetSecurityInfo0(
  [in]  HANDLE               engineHandle,
  [in]  SECURITY_INFORMATION securityInfo,
  [out] PSID                 *sidOwner,
  [out] PSID                 *sidGroup,
  [out] PACL                 *dacl,
  [out] 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] sidOwner

Tipo: PSID*

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

[out] sidGroup

Tipo: PSID*

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

[out] dacl

Tipo: PACL*

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

[out] 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 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 .

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

Consulte también

FwpmvSwitchEventsSetSecurityInfo0

Funciones de PMA