Condividi tramite

Funzione FwpmEngineGetSecurityInfo0 (fwpmk.h)

  • Articolo

La funzione FwpmEngineGetSecurityInfo0 recupera una copia del descrittore di sicurezza per il motore di filtro.

Sintassi

NTSTATUS FwpmEngineGetSecurityInfo0(
  [in]  HANDLE               engineHandle,
  [in]  SECURITY_INFORMATION securityInfo,
  [out] PSID                 *sidOwner,
  [out] PSID                 *sidGroup,
  [out] PACL                 *dacl,
  [out] PACL                 *sacl,
  [out] PSECURITY_DESCRIPTOR *securityDescriptor
);

Parametri

[in] engineHandle

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

[in] securityInfo

Tipo di informazioni di sicurezza da recuperare.

[out] sidOwner

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

[out] sidGroup

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

[out] dacl

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

[out] sacl

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

[out] securityDescriptor

Descrittore di sicurezza restituito.

Valore restituito

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.
Altri codici NTSTATUS Si è verificato un errore.

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.

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

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows Vista.
piattaforma di destinazione Universale
intestazione fwpmk.h
libreria fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Vedere anche