AtlGetSecurityDescriptor

Wywołanie tej funkcji, aby pobrać deskryptora zabezpieczeń danego obiektu.

Ważne
Nie można użyć tej funkcji w aplikacjach, które są wykonywane w Środowisko wykonawcze systemu Windows.

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

Parametry

• pszObjectName
  Wskaźnik ciąg zakończony zerem, określający nazwę obiektu, z którego można pobrać informacji o zabezpieczeniach.

• ObjectType
  Określa wartość z SE_OBJECT_TYPE wyliczenia wskazująca typ obiektu, identyfikowane przez pszObjectName parametru.

• pSecurityDescriptor
  Obiekt, który odbiera deskryptora zabezpieczeń żądana.

• requestedInfo
  Zestaw SECURITY_INFORMATION bit flagi wskazujące typ informacji o zabezpieczeniach do pobrania.Ten parametr może być kombinacją następujących wartości.

• bRequestNeededPrivileges
  Jeśli wartość true, funkcja będzie próbował włączyć przywileju SE_SECURITY_NAME i przywrócić ją po zakończeniu.

Wartość zwracana

Zwraca wartość true w przypadku powodzenia, false w przypadku niepowodzenia.

Uwagi

Jeśli AtlGetSecurityDescriptor jest wiele różnych obiektów można wywołać wiele razy będzie bardziej efektywne, aby włączyć przywileju SE_SECURITY_NAME raz przed wywołaniem funkcji, z bRequestNeededPrivileges wartość false.

Wymagania

Nagłówek: atlsecurity.h

Zobacz też

Inne zasoby

Globalne funkcje zabezpieczeń