LookupAccountSid()
의미
SID로부터 계정(Account) 정보를 얻어 오는 함수.
(사용자 이름, 도메인 이름, SID 타입 구할 수 있음)
원형
BOOL WINAPI LookupAccountSid(
__in_opt LPCTSTR lpSystemName,
__in PSID lpSid,
__out_opt LPTSTR lpName,
__in_out LPDWORD cchName,
__out_opt LPTSTR lpReferencedDomainName,
__in_out LPDWORD cchReferencedDomainName,
__out PSID_NAME_USE peUse
);
Parameter
lpSystemName
- SID가 속한 컴퓨터 이름(널문자로 끝나는)
- 원격 컴퓨터 이름 가능
- NULL 값 일 때는 Local 컴퓨터를 대상으로 함.
lpSid
- 조사 대상 SID
lpName
- SID 에서 조사한 사용자 이름 (Null –terminated)
cchName
- lpName 버퍼의 크기(size, in TCHARs)
lpReferencedDomainName
- 계정 이름이 위치한 Domain 이름. (Null-terminated)
cchReferencedDomainName
- lpReferencedDomainName 버퍼의 크기(size, in TCHARs)
peUse
- 계정의 타입 (SID_NAME_USE 값)
typedef enum _SID_NAME_USE
{
SidTypeUser = 1,
SidTypeGroup,
SidTypeDomain,
SidTypeAlias,
SidTypeWellKnownGroup,
SidTypeDeleteAccount,
SidTypeInvalid,
SidTypeUnknown,
SidTypeComputer,
SidTypeLabel1
}SID_NAME_USE, *PSID_NAME_USE;
Constants
SidTypeUser
A user SID.
SidTypeGroup
A group SID.
SidTypeDomain
A domain SID.
SidTypeAlias
An alias SID.
SidTypeWellKnownGroup
A SID for a well-known group.
SidTypeDeletedAccount
A SID for a deleted account.
SidTypeInvalid
A SID that is not valid.
SidTypeUnknown
A SID of unknown type.
SidTypeComputer
A SID for a computer.
SidTypeLabel
A mandatory integrity label SID.
Return Value
성공 시 : 0 이 아닌 값
실패 시 : 0 (GetLastError 로 자세한 정보 얻음)
Windows NT 4.0: Forest lookup and account lookup by SIDhistory are not supported
ms-help://MS.VSCC.v90/MS.MSDNQTR.v90.ko/secauthz/security/lookupaccountsid.htm