AtlGetSecurityDescriptor

Rufen Sie diese Funktion auf, um die Sicherheitsbeschreibung eines angegebenen Objekts abzurufen.

Wichtig
Diese Funktion kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.

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(...);

Parameter

• pszObjectName
  Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Objekts angibt, von dem Sicherheitsinformationen abrufen.

• ObjectType
  Gibt einen Wert aus der Enumeration SE_OBJECT_TYPE an, die den Typ des Objekts identifiziert durch den pszObjectName -Parameter angibt.

• pSecurityDescriptor
  Das Objekt, das die angeforderte Sicherheitsbeschreibung empfängt.

• requestedInfo
  Ein Satz von SECURITY_INFORMATION Bitflags, die den Typ der Sicherheitsinformationen angeben, um abzurufen.Dieser Parameter kann eine Kombination der folgenden Werte sein.

• bRequestNeededPrivileges
  Wenn true, die Funktion versucht, das SE_SECURITY_NAME-Recht aktivieren und es auf Abschluss wiederherstellt.

Rückgabewert

Gibt bei Erfolg true zurück, bei einem Fehler false.

Hinweise

Wenn AtlGetSecurityDescriptor aufgerufen werden soll oft auf vielen verschiedenen Objekten, ist es effizienter, das SE_SECURITY_NAME-Recht einmal zu aktivieren, bevor die Funktion aufgerufen wird, wenn bRequestNeededPrivileges auf false festgelegt ist.

Anforderungen

Header: atlsecurity.h

Siehe auch

Weitere Ressourcen

Sicherheits-globale Funktionen