SecurityDescriptor.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	CSecurityDescriptor

Functions
BOOL	GetTextualSid (PSID pSid, LPTSTR TextualSid, LPDWORD lpdwBufferLen)
const TCHAR *	GetSidTypeName (SID_NAME_USE Use)

Function Documentation

GetSidTypeName()

const TCHAR * GetSidTypeName

(

SID_NAME_USE

Use

)

Definition at line 106 of file SecurityDescriptor.cpp.

{
    switch(Use)
    {
    case SidTypeUser:
        return _T("User SID");
    case SidTypeGroup:
        return _T("Group SID");
    case SidTypeDomain:
        return _T("Domain SID");
    case SidTypeAlias:
        return _T("Alias SID");
    case SidTypeWellKnownGroup:
        return _T("SID for a well-known group");
    case SidTypeDeletedAccount:
        return _T("SID for a deleted account");
    case SidTypeInvalid:
        return _T("Invalid SID");
    case SidTypeUnknown:
        return _T("Unknown SID type");
    default:
        return _T("Error. Cannot recognize SID type.");
    }
}

Referenced by CShellCommandDACL::Execute(), CShellCommandOwner::Execute(), and CShellCommandSACL::Execute().

GetTextualSid()

BOOL GetTextualSid	(	PSID	pSid,
		LPTSTR	TextualSid,
		LPDWORD	lpdwBufferLen
	)

Definition at line 29 of file SecurityDescriptor.cpp.

{
    PSID_IDENTIFIER_AUTHORITY psia;
    DWORD dwSubAuthorities;
    DWORD dwSidRev=SID_REVISION;
    DWORD dwCounter;
    DWORD dwSidSize;
 
    // Validate the binary SID.
 
    if(!IsValidSid(pSid)) return FALSE;
 
    // Get the identifier authority value from the SID.
 
    psia = GetSidIdentifierAuthority(pSid);
 
    // Get the number of subauthorities in the SID.
 
    dwSubAuthorities = *GetSidSubAuthorityCount(pSid);
 
    // Compute the buffer length.
    // S-SID_REVISION- + IdentifierAuthority- + subauthorities- + NULL
 
    dwSidSize=(15 + 12 + (12 * dwSubAuthorities) + 1) * sizeof(TCHAR);
 
    // Check input buffer length.
    // If too small, indicate the proper size and set last error.
 
    if (*lpdwBufferLen < dwSidSize)
    {
        *lpdwBufferLen = dwSidSize;
        SetLastError(ERROR_INSUFFICIENT_BUFFER);
        return FALSE;
    }
 
    // Add 'S' prefix and revision number to the string.
 
    dwSidSize=wsprintf(TextualSid, TEXT("S-%lu-"), dwSidRev );
 
    // Add SID identifier authority to the string.
 
    if ( (psia->Value[0] != 0) || (psia->Value[1] != 0) )
    {
        dwSidSize+=wsprintf(TextualSid + lstrlen(TextualSid),
                    TEXT("0x%02hx%02hx%02hx%02hx%02hx%02hx"),
                    (USHORT)psia->Value[0],
                    (USHORT)psia->Value[1],
                    (USHORT)psia->Value[2],
                    (USHORT)psia->Value[3],
                    (USHORT)psia->Value[4],
                    (USHORT)psia->Value[5]);
    }
    else
    {
        dwSidSize+=wsprintf(TextualSid + lstrlen(TextualSid),
                    TEXT("%lu"),
                    (ULONG)(psia->Value[5]      )   +
                    (ULONG)(psia->Value[4] <<  8)   +
                    (ULONG)(psia->Value[3] << 16)   +
                    (ULONG)(psia->Value[2] << 24)   );
    }
 
    // Add SID subauthorities to the string.
    //
    for (dwCounter=0 ; dwCounter < dwSubAuthorities ; dwCounter++)
    {
        dwSidSize+=wsprintf(TextualSid + dwSidSize, TEXT("-%lu"),
                    *GetSidSubAuthority(pSid, dwCounter) );
    }
 
    return TRUE;
}

Referenced by CShellCommandDACL::Execute(), CShellCommandOwner::Execute(), and CShellCommandSACL::Execute().