LsaGetLogonSessionData 함수(ntsecapi.h)

LsaGetLogonSessionData 함수는 지정된 로그온 세션에 대한 정보를 검색합니다.

로그온 세션에 대한 정보를 검색하려면 호출자가 세션의 소유자이거나 로컬 시스템 관리자여야 합니다.

구문

NTSTATUS LsaGetLogonSessionData(
  [in]  PLUID                        LogonId,
  [out] PSECURITY_LOGON_SESSION_DATA *ppLogonSessionData
);

매개 변수

[in] LogonId

정보를 검색할 로그온 세션을 식별하는 LUID 에 대한 포인터를 지정합니다. 이 매개 변수의 유효한 값에 대한 자세한 내용은 비고를 참조하세요.

[out] ppLogonSessionData

LogonId로 지정된 로그온 세션에 대한 정보를 포함하는 SECURITY_LOGON_SESSION_DATA 구조체에 대한 포인터의 주소입니다. 이 구조체는 LSA에 의해 할당됩니다. 정보가 더 이상 필요하지 않은 경우 LsaFreeReturnBuffer 함수를 호출하여 이 구조체에서 사용하는 메모리를 해제합니다.

반환 값

함수가 성공하면 반환 값이 STATUS_SUCCESS.

함수가 실패하면 반환 값은 이유를 나타내는 NTSTATUS 코드입니다.

설명

이 함수의 LogonId 매개 변수에 전달될 수 있는 유효한 로그온 세션 식별자를 가져오려면 LsaEnumerateLogonSessions 함수를 호출합니다.

LogonID가 LocalSystem 계정(0x0:0x3e7)을 지정하는 경우 이 함수는 ppLogonSessionData에서 검색된 로그온 세션 데이터에 대해 0을 반환합니다. 그 이유는 LocalSystem 계정이 일반적인 로그온 방식으로 로그온되지 않기 때문입니다. 대신 시스템이 시작된 후 LocalSystem 계정이 활성화됩니다.

요구 사항

지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ntsecapi.h
라이브러리	Secur32.lib
DLL	Secur32.dll