The InitializeSid function initializes a SID structure. An SID is a security identifier.
BOOL InitializeSid(
PSID Sid, // address of SID to initialize
PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
// address of identifier authority
BYTE nSubAuthorityCount // count of subauthorities
);
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.
Although the InitializeSid function sets the number of subauthorities for the SID, it does not set the subauthority values. This must be done separately, using functions, such as GetSidSubAuthority.
An application can use the AllocateAndInitializeSid function to initialize a SID and set its subauthority values.
Windows NT: Requires version 3.1 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in winbase.h.
Import Library: Use advapi32.lib.
Access Control Overview, Access Control Functions, AllocateAndInitializeSid, GetLengthSid, GetSidIdentifierAuthority, GetSidLengthRequired, GetSidSubAuthority, GetSidSubAuthorityCount, IsValidSid, SID, SID_IDENTIFIER_AUTHORITY