Compartir a través de

Función FwpmProviderContextGetSecurityInfoByKey0 (fwpmu.h)

  • Artículo

La función FwpmProviderContextGetSecurityInfoByKey0 recupera una copia del descriptor de seguridad para un objeto de contexto de proveedor.

Sintaxis

DWORD FwpmProviderContextGetSecurityInfoByKey0(
  [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*

Identificador único del contexto del proveedor. Se trata de un puntero al mismo GUID que se especificó cuando la aplicación llamada FwpmProviderContextAdd0 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 contextos del proveedor.

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 .

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

FwpmProviderContextSetSecurityInfoByKey0