GetSecurityInfo(3w)

Usage

DWORD GetSecurityInfo
(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
SECURITY_INFORMATION SecurityInfo,
PSID* ppsidOwner,
PSID* ppsidGroup,
PACL* ppDacl,
PACL* ppSacl,
PSECURITY_DESCRIPTOR* ppSecurityDescriptor
)

Overview

Retrieves a copy of the security descriptor associated with an object.

Params

hObject [In] A handle for the object.

ObjectType [In] The type of object.

SecurityInfo [In] A bitmask indicating what information to retrieve.

ppsidOwner [Out] If non-NULL, receives a pointer to the owner SID.

ppsidGroup [Out] If non-NULL, receives a pointer to the group SID.

ppDacl [Out] If non-NULL, receives a pointer to the DACL.

ppSacl [Out] If non-NULL, receives a pointer to the SACL.

ppSecurityDescriptor [Out] Receives a pointer to the security descriptor, which must be freed with LocalFree.

Returns

ERROR_SUCCESS if all's well, and a Win32 error code otherwise.

Implementation

Declared in "aclapi.h".

Implemented in "dlls/advapi32/security.c".

Debug channel "advapi".