LookupAccountSidLocalA 함수(winbase.h)

아티클
03/08/2023

LookupAccountSidLocalA 는 를 첫 번째 매개 변수로 사용하여 LookupAccountSidA 를 NULL 호출하는 매크로로 정의됩니다. 로컬 컴퓨터에서 지정된 SID에 대한 계정의 이름을 검색합니다.

구문

BOOL LookupAccountSidLocalA(
  [in]            PSID          Sid,
  [out, optional] LPSTR         Name,
  [in, out]       LPDWORD       cchName,
  [out, optional] LPSTR         ReferencedDomainName,
  [in, out]       LPDWORD       cchReferencedDomainName,
  [out]           PSID_NAME_USE peUse
);

매개 변수

[in] Sid

조회할 SID 에 대한 포인터입니다.

[out, optional] Name

lpSid 매개 변수에 해당하는 계정 이름을 포함하는 null로 끝나는 문자열을 수신하는 버퍼에 대한 포인터입니다.

[in, out] cchName

입력 시 lpName 버퍼의 크기(TCHARs)를 지정합니다. 버퍼가 너무 작거나 cchName 이 0인 경우 함수가 실패하면 cchName 은 종료 null 문자를 포함하여 필요한 버퍼 크기를 받습니다.

[out, optional] ReferencedDomainName

계정 이름이 발견된 도메인의 이름을 포함하는 null로 끝나는 문자열을 수신하는 버퍼에 대한 포인터입니다.

서버에서 로컬 컴퓨터의 보안 데이터베이스에 있는 대부분의 계정에 대해 반환되는 도메인 이름은 서버가 도메인 컨트롤러인 도메인의 이름입니다.

워크스테이션에서 로컬 컴퓨터의 보안 데이터베이스에 있는 대부분의 계정에 대해 반환되는 도메인 이름은 시스템의 마지막 시작부터 컴퓨터의 이름입니다(백슬라이쉬는 제외됨). 컴퓨터 이름이 변경되면 시스템이 다시 시작될 때까지 이전 이름이 도메인 이름으로 계속 반환됩니다.

일부 계정은 시스템에서 미리 정의됩니다. 이러한 계정에 대해 반환된 도메인 이름은 BUILTIN입니다.

[in, out] cchReferencedDomainName

입력 시 lpReferencedDomainName 버퍼의 크기(TCHAR)를 지정합니다. 버퍼가 너무 작거나 cchReferencedDomainName이 0이면 종료되는 null 문자를 포함하여 cchReferencedDomainName이 필요한 버퍼 크기를 수신하므로 함수가 실패합니다.

[out] peUse

계정 유형을 나타내는 SID_NAME_USE 값을 받는 변수에 대한 포인터입니다.

반환 값

함수가 성공하면 함수는 0이 아닌 값을 반환합니다.

함수가 실패하면 0을 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

이 함수는 LookupAccountSid와 비슷하지만 검색을 로컬 컴퓨터로 제한합니다.

참고

winbase.h 헤더는 LOOKupAccountSidLocal을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)