Funzione CreateSecurityPage (aclui.h)

Articolo
02/26/2024

La funzione CreateSecurityPage crea una pagina di proprietà di sicurezza di base che consente all'utente di visualizzare e modificare i diritti di accesso consentiti o negati dalle voci di controllo di accesso (ACEs) dell'oggetto nell'elenco di controllo degli accessi discrezionale (DACL). Utilizzare la funzione PropertySheet o il messaggio PSM_ADDPAGE per aggiungere questa pagina a un foglio delle proprietà.

Sintassi

HPROPSHEETPAGE ACLUIAPI CreateSecurityPage(
  [in] LPSECURITYINFO psi
);

Parametri

[in] psi

Puntatore all'implementazione dell'interfaccia ISecurityInformation . Il sistema chiama i metodi di interfaccia per recuperare informazioni sull'oggetto modificato e per restituire l'input dell'utente.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un handle a una pagina di proprietà di sicurezza di base.

Se la funzione ha esito negativo, restituisce NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Durante l'inizializzazione della pagina delle proprietà, il sistema chiama i metodi ISecurityInformation::GetSecurity e ISecurityInformation::SetSecurity per determinare se l'utente ha l'autorizzazione per modificare il descrittore di sicurezza dell'oggetto. Il sistema visualizza un messaggio di errore se l'utente non dispone dell'autorizzazione.

La pagina della proprietà di sicurezza di base può includere un pulsante Avanzate per visualizzare la scheda delle proprietà di sicurezza avanzata. Questa scheda delle proprietà di sicurezza avanzata può contenere tre pagine di proprietà aggiuntive che consentono all'utente di visualizzare e modificare l'elenco daCL dell'oggetto, l'elenco di controllo di accesso del sistema (SACL) e il proprietario.

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
Libreria	Aclui.lib
DLL	Aclui.dll