Metodo ISecurityInformation::GetSecurity (aclui.h)
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.
[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
Funzioni dell'editor Controllo di accesso