Metodo ISecurityInformation::SetSecurity (aclui.h)

  • Articolo

Il metodo SetSecurity fornisce un descrittore di sicurezza contenente le informazioni di sicurezza che l'utente desidera applicare all'oggetto a protezione diretta. L'editor di controllo di accesso chiama questo metodo quando l'utente fa clic su Ok o Applica.

Sintassi

HRESULT SetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parametri

[in] SecurityInformation

Set di flag di bit SECURITY_INFORMATION che indicano le parti del descrittore di sicurezza da impostare. Questo parametro può essere una combinazione dei valori seguenti.

Valore Significato
OWNER_SECURITY_INFORMATION
 Il descrittore di sicurezza contiene il SID del proprietario dell'oggetto.
GROUP_SECURITY_INFORMATION
 Il descrittore di sicurezza contiene il SID del gruppo primario dell'oggetto.
DACL_SECURITY_INFORMATION
 Il descrittore di sicurezza contiene l'elenco DACL dell'oggetto.
SACL_SECURITY_INFORMATION
 Il descrittore di sicurezza contiene l'elenco SACL dell'oggetto.

[in] pSecurityDescriptor

Puntatore a un descrittore di sicurezza contenente le nuove informazioni di sicurezza. Non presupporre che il descrittore di sicurezza sia in forma auto-relativa ; può essere assoluto o auto-relativo.

Valore restituito

Restituisce S_OK in caso di esito positivo.

Restituisce un codice di errore diverso da zero se si verifica un errore.

Commenti

Per compilare un descrittore di sicurezza completo per l'oggetto, l'applicazione deve unire le nuove parti del descrittore di sicurezza, come definito dal parametro SecurityInformation , nel descrittore di sicurezza esistente dell'oggetto.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione aclui.h

Vedi anche

Editor Controllo di accesso

Funzioni dell'editor Controllo di accesso

ISecurityInformation

SECURITY_INFORMATION