◆ GetWellKnownSid() [8/9]

AutoSID Chusov::Win32::Security::GetWellKnownSid	(	sid_authority_t	authority_id,
		DWORD	dwSubAuthority0,
		DWORD	dwSubAuthority1,
		DWORD	dwSubAuthority2,
		DWORD	dwSubAuthority3,
		DWORD	dwSubAuthority4,
		DWORD	dwSubAuthority5,
		DWORD	dwSubAuthority6,
		DWORD	dwSubAuthority7
	)

A wrapper over the Windows API AllocateAndInitializeSid function used to create well-known security identifiers.

Parameters

authority_id	A top-level identifier authority value to set in the SID with respect to the Chusov::Win32::Security::sid_authority_t values.
dwSubAuthority0	is a subauthority value to place in the SID.
dwSubAuthority1	is a subauthority value to place in the SID.
dwSubAuthority2	is a subauthority value to place in the SID.
dwSubAuthority3	is a subauthority value to place in the SID.
dwSubAuthority4	is a subauthority value to place in the SID.
dwSubAuthority5	is a subauthority value to place in the SID.
dwSubAuthority6	is a subauthority value to place in the SID.
dwSubAuthority7	is a subauthority value to place in the SID.

Returns: A managed pointer of the AutoSID type to the created security identifier. In case of error the function throws corresponding exception as defined by the Chusov::Win32::Exceptions::ChsvExceptionByWin32Code function.