Funzione FwpmNetEventsGetSecurityInfo0 (fwpmu.h)

Articolo
06/27/2024

La funzione FwpmNetEventsGetSecurityInfo0 recupera una copia del descrittore di sicurezza per un oggetto evento di rete.

Sintassi

DWORD FwpmNetEventsGetSecurityInfo0(
  [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
);

Parametri

[in] engineHandle

Tipo: HANDLE

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] securityInfo

Tipo: SECURITY_INFORMATION

Tipo di informazioni di sicurezza da recuperare.

[out, optional] sidOwner

Tipo: PSID*

Identificatore di sicurezza del proprietario (SID) nel descrittore di sicurezza restituito.

[out, optional] sidGroup

Tipo: PSID*

Identificatore di sicurezza del gruppo primario (SID) nel descrittore di sicurezza restituito.

[out, optional] dacl

Tipo: pacl*

Elenco di controllo di accesso discrezionale (DACL) nel descrittore di sicurezza restituito.

[out, optional] sacl

Tipo: pacl*

Elenco di controllo di accesso di sistema (SACL) nel descrittore di sicurezza restituito.

[out] securityDescriptor

Tipo: PSECURITY_DESCRIPTOR*

Descrittore di sicurezza restituito.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	Il descrittore di sicurezza è stato recuperato correttamente.
*FWP_E_ codice di errore** 0x80320001: 0x80320039	Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere codici di errore WFP.
*RPC_ codice di errore** 0x80010001: 0x80010122	Errore di comunicazione con il motore firewall remoto o locale.

Osservazioni

Il parametro securityDescriptor restituito deve essere liberato tramite una chiamata a FwpmFreeMemory0. Gli altri quattro parametri (facoltativi) restituiti non devono essere liberati, perché puntano agli indirizzi all'interno del parametro securityDescriptor.

Questa funzione si comporta come la funzione Win32 standard GetSecurityInfo. Il chiamante necessita degli stessi diritti di accesso standard descritti nell'argomento di riferimento GetSecurityInfo.

FwpmNetEventsGetSecurityInfo0 è un'implementazione specifica di FwpmNetEventsGetSecurityInfo. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	fwpmu.h
libreria	Fwpuclnt.lib
dll	Fwpuclnt.dll

Vedere anche

FwpmNetEventsSetSecurityInfo0

Condividi tramite