Función FwpmEngineGetSecurityInfo0 (fwpmu.h)
La función FwpmEngineGetSecurityInfo0 recupera una copia del descriptor de seguridad del motor de filtro.
Sintaxis
DWORD FwpmEngineGetSecurityInfo0(
[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*
La lista de control de acceso discrecional (DACL) en el descriptor de seguridad devuelto.
[out, optional] sacl
Tipo: PACL*
La 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 |
|---|---|
|
El descriptor de seguridad se recuperó correctamente. |
|
Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información. |
|
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 Estándar GetSecurityInfo de Win32 . El autor de la llamada necesita los mismos derechos de acceso estándar que se describen en el tema de referencia GetSecurityInfo .
FwpmEngineGetSecurityInfo0 es una implementación específica de FwpmEngineGetSecurityInfo. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios.
Ejemplos
En el siguiente ejemplo de C++ se muestra la inicialización de un objeto descriptor de seguridad mediante FwpmEngineGetSecurityInfo0.
#include <windows.h>
#include <fwpmu.h>
#include <stdio.h>
#pragma comment(lib, "Fwpuclnt.lib")
void main()
{
HANDLE engineHandle = NULL;
DWORD result = ERROR_SUCCESS;
PSECURITY_DESCRIPTOR securityDescriptor;
SECURITY_INFORMATION securityInfo = OWNER_SECURITY_INFORMATION;
// Several functions that use the SECURITY_DESCRIPTOR structure require that this
// structure be aligned on a valid pointer boundary in memory. These boundaries
// vary depending on the type of processor used.
securityDescriptor = (PSECURITY_DESCRIPTOR) malloc(sizeof(SECURITY_DESCRIPTOR));
result = FwpmEngineOpen0( NULL, RPC_C_AUTHN_WINNT, NULL, NULL, &engineHandle );
if (result != ERROR_SUCCESS)
{
printf("FwpmEngineOpen0 failed.\n");
return;
}
result = FwpmEngineGetSecurityInfo0(
engineHandle,
securityInfo,
NULL,
NULL,
NULL,
NULL,
&securityDescriptor);
if (result != ERROR_SUCCESS)
{
printf("FwpmEngineGetSecurityInfo0 failed.\n");
return;
}
return;
}
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 |