Condividi tramite

Funzione FwpmCalloutSetSecurityInfoByKey0 (fwpmk.h)

  • Articolo

La funzione FwpmCalloutSetSecurityInfoByKey0 imposta le informazioni di sicurezza specificate nel descrittore di sicurezza di un oggetto callout.

Sintassi

NTSTATUS FwpmCalloutSetSecurityInfoByKey0(
  [in]           HANDLE               engineHandle,
  [in, optional] const GUID           *key,
  [in]           SECURITY_INFORMATION securityInfo,
  [in, optional] const SID            *sidOwner,
  [in, optional] const SID            *sidGroup,
  [in, optional] const ACL            *dacl,
  [in, optional] const ACL            *sacl
);

Parametri

[in] engineHandle

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

[in, optional] key

Puntatore a un GUID che identifica in modo univoco il callout. Questo GUID è stato specificato nel membro calloutKey del parametro callout quando l'applicazione ha chiamato FwpmCalloutAdd0 per questo oggetto.

[in] securityInfo

Tipo di informazioni di sicurezza da impostare.

[in, optional] sidOwner

Identificatore di sicurezza (SID) del proprietario da impostare nel descrittore di sicurezza.

[in, optional] sidGroup

SID del gruppo da impostare nel descrittore di sicurezza.

[in, optional] dacl

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

[in, optional] sacl

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

Valore restituito

Codice/valore restituito Descrizione
ERROR_SUCCESS
0		 Il descrittore di sicurezza è stato impostato 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

Se il parametro chiave è NULL o se si tratta di un GUID NULL, questa funzione gestisce le informazioni di sicurezza del contenitore dei callout.

Questa funzione non può essere chiamata dall'interno di una transazione, ma ha esito negativo con FWP_E_TXN_IN_PROGRESS. Per altre informazioni sulle transazioni, vedere Gestione oggetti.

Questa funzione può essere chiamata all'interno di una sessione dinamica se l'oggetto corrispondente è stato aggiunto durante la stessa sessione. Se questa funzione viene chiamata per un oggetto aggiunto durante una sessione dinamica diversa, l'operazione ha esito negativo con FWP_E_WRONG_SESSION. Se questa funzione viene chiamata per un oggetto che non è stato aggiunto durante una sessione dinamica, l'operazione ha esito negativo con FWP_E_DYNAMIC_SESSION_IN_PROGRESS.

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

FwpmCalloutSetSecurityInfoByKey0 è un'implementazione specifica di FwpmCalloutSetSecurityInfoByKey. 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
Biblioteca fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

Vedere anche