Condividi tramite


AtlGetSecurityDescriptor

Chiamare questa funzione per recuperare il descrittore di sicurezza per un oggetto specificato.

Importante

Questa funzione non può essere utilizzata nelle applicazioni eseguite in Windows Runtime.

inline bool AtlGetSecurityDescriptor( 
LPCTSTR pszObjectName, 
SE_OBJECT_TYPE ObjectType, 
CSecurityDesc * pSecurityDescriptor, 
SECURITY_INFORMATION requestedInfo= OWNER_SECURITY_INFORMATION |  
GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION |  
SACL_SECURITY_INFORMATION, 
bool bRequestNeededPrivileges= true 
) throw(...);

Parametri

  • pszObjectName
    Puntatore a una stringa con terminazione null che specifica il nome dell'oggetto da cui recuperare informazioni sulla sicurezza.

  • ObjectType
    Specifica un valore dall'enumerazione SE_OBJECT_TYPE che indica il tipo di oggetto identificato dal parametro di pszObjectName .

  • pSecurityDescriptor
    l'oggetto che riceve il descrittore di sicurezza richiesto.

  • requestedInfo
    Un set di flag di bit SECURITY_INFORMATION che indicano il tipo di informazioni sulla sicurezza per recuperare. Questo parametro può essere una combinazione dei valori seguenti.

  • bRequestNeededPrivileges
    Se true, la funzione tenta di abilitare il privilegio di SE_SECURITY_NAME e viene reimpostata sul completamento.

Valore restituito

Restituisce true se l'operazione ha esito positivo, false in caso di esito negativo.

Note

Se AtlGetSecurityDescriptor deve essere chiamato più volte su molti oggetti diversi, sarà più efficiente abilitare una volta il privilegio di SE_SECURITY_NAME prima di chiamare la funzione, con bRequestNeededPrivileges impostato su false.

Requisiti

Header: atlsecurity.h

Vedere anche

Altre risorse

Security Global Functions