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ń