WLX_CONSOLESWITCH_CREDENTIALS_INFO_V1_0 구조체(winwlx.h)

아티클
03/04/2024

WLX_CONSOLESWITCH_CREDENTIALS_INFO_V1_0 구조에는 WlxGetConsoleSwitchCredentials 호출로 반환된 클라이언트 자격 증명이 포함됩니다.

이렇게 하면 자격 증명을 대상 세션으로 투명하게 전송할 수 있습니다.

구문

typedef struct _WLX_CONSOLESWITCH_CREDENTIALS_INFO {
  DWORD         dwType;
  HANDLE        UserToken;
  LUID          LogonId;
  QUOTA_LIMITS  Quotas;
  PWSTR         UserName;
  PWSTR         Domain;
  LARGE_INTEGER LogonTime;
  BOOL          SmartCardLogon;
  ULONG         ProfileLength;
  DWORD         MessageType;
  USHORT        LogonCount;
  USHORT        BadPasswordCount;
  LARGE_INTEGER ProfileLogonTime;
  LARGE_INTEGER LogoffTime;
  LARGE_INTEGER KickOffTime;
  LARGE_INTEGER PasswordLastSet;
  LARGE_INTEGER PasswordCanChange;
  LARGE_INTEGER PasswordMustChange;
  PWSTR         LogonScript;
  PWSTR         HomeDirectory;
  PWSTR         FullName;
  PWSTR         ProfilePath;
  PWSTR         HomeDirectoryDrive;
  PWSTR         LogonServer;
  ULONG         UserFlags;
  ULONG         PrivateDataLen;
  PBYTE         PrivateData;
} WLX_CONSOLESWITCH_CREDENTIALS_INFO_V1_0, *PWLX_CONSOLESWITCH_CREDENTIALS_INFO_V1_0;

멤버

dwType

할당되는 자격 증명 구조의 유형을 식별합니다. 자격 증명 형식은 접두사 WLX_CONSOLESWITCHCREDENTIAL_TYPE 정의되므로 Winlogon은 구조체의 나머지 부분을 참조할 수 있도록 구조체를 형식 캐스팅할 수 있습니다.

UserToken

사용자 토큰의 핸들입니다.

LogonId

고유 로그온 식별자입니다.

Quotas

QUOTA_LIMITS 사용자가 사용할 수 있는 시스템 리소스의 양에 대한 정보를 포함하는 구조입니다.

UserName

사용자의 이름을 문자열로 지정합니다.

Domain

사용자의 도메인을 문자열로 사용합니다.

LogonTime

정확한 로그온 시간입니다.

SmartCardLogon

TRUE 이면 SmartCard에서 로그온을 수행했습니다.

ProfileLength

사용자 프로필의 길이(바이트)입니다.

MessageType

반환 되는 프로필 데이터의 형식을 식별하는 MSV1_0_PROFILE_BUFFER_TYPE 값입니다. 이 멤버는 MsV1_0InteractiveProfile 설정해야 합니다.

LogonCount

사용자가 현재 로그온한 횟수입니다.

참고 도메인 컨트롤러에 모든 로그온 및 로그오프에 대한 알림이 표시되지 않으므로 이 값이 정확하지 않을 수 있습니다.

BadPasswordCount

마지막으로 로그온한 이후 유효하지 않은 암호가 계정에 적용된 횟수입니다.

ProfileLogonTime

사용자가 마지막으로 로그온한 시간입니다. 이는 절대 형식 Windows 표준 시간 값입니다.

LogoffTime

사용자가 로그오프해야 하는 시간입니다. 이는 절대 형식 Windows 표준 시간 값입니다.

KickOffTime

시스템에서 사용자가 로그오프하도록 강제해야 하는 시간입니다. 이는 절대 형식 Windows 표준 시간 값입니다. Windows 사용자는 대화형으로 로그오프할 필요가 없습니다. 그러나 네트워크 연결이 닫혀 있을 수 있습니다.

PasswordLastSet

암호가 마지막으로 변경된 시간과 날짜입니다. 이는 Windows 표준 시간 값의 절대 형식입니다.

PasswordCanChange

사용자에게 암호를 변경하라는 알림을 보내야 하는 시간 및 날짜입니다. 이는 절대 형식 Windows 표준 시간 값입니다. 이 멤버는 GINA 에서 사용자가 현재 암호를 변경할 것인지 묻는 프롬프트를 표시하는 데 사용됩니다.

PasswordMustChange

사용자가 암호를 변경해야 하는 시간과 날짜입니다. 사용자가 암호를 변경할 수 없는 경우 이 멤버는 정의되지 않습니다. 절대 형식인 Windows, 표준 시간 값입니다.

LogonScript

UNICODE_STRING 계정의 로그온 스크립트에 대한 상대 경로를 포함합니다.

HomeDirectory

UNICODE_STRING 사용자의 홈 디렉터리를 포함합니다.

FullName

사용자의 전체 이름을 포함하는 UNICODE_STRING.

ProfilePath

사용자에게 로밍 프로필이 있는 경우 사용자의 로밍 프로필 경로를 지정하는 UNICODE_STRING. 예: \SomeServer\SomeShare\MyUserName

HomeDirectoryDrive

UNICODE_STRING 홈 디렉터리의 드라이브 문자(예: C:\ 또는 D:)를 포함합니다.

LogonServer

UNICODE_STRING 로그온 요청을 처리한 서버의 이름을 포함합니다.

UserFlags

이 사용자가 세션을 설정하는 방법을 지정합니다. 다음 플래그가 될 수 있습니다.

값	의미
LOGON_EXTRA_SIDS	사용자가 추가 SID를 사용하여 로그온 했습니다.

PrivateDataLen

GINA 관련 데이터의 길이(바이트)입니다. GINA 특정 데이터가 없으면 0으로 설정합니다.

PrivateData

GINA 관련 데이터를 포함하는 버퍼입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	winwlx.h

다음을 통해 공유

WLX_CONSOLESWITCH_CREDENTIALS_INFO_V1_0 구조체(winwlx.h)

구문

멤버

요구 사항

피드백

추가 리소스