The GetPrivateObjectSecurity retrieves information from a private object's security descriptor.
BOOL GetPrivateObjectSecurity(
PSECURITY_DESCRIPTOR ObjectDescriptor,
// address of SD to query
SECURITY_INFORMATION SecurityInformation,
// requested information
PSECURITY_DESCRIPTOR ResultantDescriptor,
// address of retrieved SD
DWORD DescriptorLength, // size of buffer for retrieved SD
PDWORD ReturnLength // address of buffer size required for SD
);
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: Requires version 3.1 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in winbase.h.
Import Library: Use advapi32.lib.
Client/Server Access Control Overview, Client/Server Access Control Functions, CreatePrivateObjectSecurity, DestroyPrivateObjectSecurity, GetFileSecurity, GetKernelObjectSecurity, GetUserObjectSecurity, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetPrivateObjectSecurity