Metodo ISecurityInformation::GetSecurity (aclui.h)

  • Articolo

Il metodo GetSecurity richiede un descrittore di sicurezza per l'oggetto a protezione diretta il cui descrittore di sicurezza viene modificato. L'editor di controllo di accesso chiama questo metodo per recuperare il descrittore di sicurezza corrente o predefinito dell'oggetto.

Sintassi

HRESULT GetSecurity(
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [in]  BOOL                 fDefault
);

Parametri

[in] RequestedInformation

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

Valore Significato
OWNER_SECURITY_INFORMATION
 Il descrittore di sicurezza deve includere il SID del proprietario dell'oggetto.
GROUP_SECURITY_INFORMATION
 Il descrittore di sicurezza deve includere il SID del gruppo primario dell'oggetto.
DACL_SECURITY_INFORMATION
 Il descrittore di sicurezza deve includere l'elenco DATI dell'oggetto.
SACL_SECURITY_INFORMATION
 Il descrittore di sicurezza deve includere IL SACL dell'oggetto.

[out] ppSecurityDescriptor

Puntatore a una variabile che l'implementazione deve impostare su un puntatore al descrittore di sicurezza dell'oggetto. Il descrittore di sicurezza deve includere i componenti richiesti dal parametro RequestedInformation .

Il sistema chiama la funzione LocalFree per liberare il puntatore restituito.

[in] fDefault

Se questo parametro è TRUE, ppSecurityDescriptor deve restituire un descrittore di sicurezza predefinito definito dall'applicazione per l'oggetto. L'editor di controllo di accesso usa questo descrittore di sicurezza predefinito per reinizializzare la pagina delle proprietà.

L'editor di controllo di accesso imposta questo parametro su TRUE solo se l'utente fa clic sul pulsante predefinito . Il pulsante Default viene visualizzato solo se si imposta il flag di SI_RESET nel metodo ISecurityInformation::GetObjectInformation . Se non è disponibile alcun descrittore di sicurezza predefinito, non impostare il flag di SI_RESET.

Se questo flag è FALSE, ppSecurityDescriptor deve restituire il descrittore di sicurezza corrente dell'oggetto.

Valore restituito

Restituisce S_OK se riuscito.

Restituisce un codice di errore diverso da zero se si verifica un errore. Restituisce E_ACCESSDENIED se l'utente non dispone dell'autorizzazione per leggere le informazioni di sicurezza richieste.

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

ISecurityInformation::GetObjectInformation

LocalFree

SECURITY_INFORMATION