Platform SDK: Access Control |
The GetPrivateObjectSecurity retrieves information from a private object's security descriptor.
BOOL GetPrivateObjectSecurity( PSECURITY_DESCRIPTOR ObjectDescriptor, // SD SECURITY_INFORMATION SecurityInformation, // requested info type PSECURITY_DESCRIPTOR ResultantDescriptor, // requested SD info DWORD DescriptorLength, // size of SD buffer PDWORD ReturnLength // required buffer size );
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
An application must perform appropriate access/privilege checks and audits before calling this function.
Windows NT/2000: Requires Windows NT 3.1 or later.
Header: Declared in Winbase.h; include Windows.h.
Library: Use Advapi32.lib.
Client/Server Access Control Overview, Client/Server Access Control Functions, CreatePrivateObjectSecurity, DestroyPrivateObjectSecurity, GetFileSecurity, GetKernelObjectSecurity, GetUserObjectSecurity, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetPrivateObjectSecurity