WlxLoggedOnSAS 함수(winwlx.h)

  • 아티클

[WlxLoggedOnSAS 함수는 Windows Server 2008 및 Windows Vista를 기준으로 더 이상 사용할 수 없습니다.]

WlxLoggedOnSAS 함수는 대체 GINA DLL에 의해 구현되어야 합니다. Winlogon 은 사용자가 로그온되고 워크스테이션이 잠겨 있지 않은 동안 SAS( 보안 주의 시퀀스 ) 이벤트를 수신할 때 이 함수를 호출합니다.

참고 GINA DLL은 Windows Vista에서 무시됩니다.
 

구문

int WlxLoggedOnSAS(
  [in] PVOID pWlxContext,
  [in] DWORD dwSasType,
  [in] PVOID pReserved
);

매개 변수

[in] pWlxContext

이 창 스테이션과 연결된 GINA 컨텍스트에 대한 포인터입니다. Winlogon이 이 스테이션에 대해 WlxInitialize 를 호출하면 GINA는 이 컨텍스트 값을 반환합니다.

[in] dwSasType

발생한 SAS 유형을 지정합니다. 0에서 WLX_SAS_TYPE_MAX_MSFT_VALUE 값은 표준 Microsoft SAS 형식을 정의하기 위해 예약되어 있습니다. GINA 개발자는 WLX_SAS_TYPE_MAX_MSFT_VALUE보다 큰 값을 사용하여 추가 SAS 형식을 정의할 수 있습니다.

다음 SAS 형식이 미리 정의되어 있습니다.

값 의미
WLX_SAS_TYPE_TIMEOUT
0(0x0)
 지정된 제한 시간 내에 사용자 입력이 수신되지 않음을 나타냅니다.
WLX_SAS_TYPE_CTRL_ALT_DEL
1(0x1)
 사용자가 표준 CTRL+ALT+DEL SAS( 보안 주의 시퀀스 )를 입력했음을 나타냅니다.
WLX_SAS_TYPE_SC_INSERT
5(0x5)
 스마트 카드 호환되는 디바이스에 삽입되었음을 나타냅니다.
WLX_SAS_TYPE_SC_REMOVE
6(0x6)
 스마트 카드 호환되는 디바이스에서 제거되었음을 나타냅니다.

[in] pReserved

이 매개 변수는 예약되어 있으며 NULL로 설정해야 합니다.

반환 값

WlxLoggedOnSAS 함수는 다음 값 중 하나를 반환해야 합니다.

반환 코드 설명
WLX_SAS_ACTION_NONE
 기본 데스크톱으로 돌아갑니다.
WLX_SAS_ACTION_LOCK_WKSTA
 워크스테이션을 잠그고 다음 SAS를 기다립니다.
WLX_SAS_ACTION_LOGOFF
 워크스테이션에서 사용자를 로그합니다.
WLX_SAS_ACTION_SHUTDOWN
 사용자를 로그오프하고 컴퓨터를 종료합니다.
WLX_SAS_ACTION_SHUTDOWN_REBOOT
 사용자를 로그오프하고 컴퓨터를 종료한 다음 컴퓨터를 다시 시작합니다.
WLX_SAS_ACTION_SHUTDOWN_POWER_OFF
 하드웨어가 허용하는 경우 사용자를 로그오프하고 컴퓨터를 종료한 다음 컴퓨터를 끕니다.
WLX_SAS_ACTION_PWD_CHANGED
 네트워크 공급자에게 사용자가 암호를 변경했음을 알 수 있습니다. 사용되지 않는 GINA DLL은 암호가 변경될 때마다 WlxChangePasswordNotify 를 호출해야 합니다.
WLX_SAS_ACTION_TASKLIST
 작업 목록을 호출합니다.
WLX_SAS_ACTION_FORCE_LOGOFF
 사용자를 강제로 로그오프합니다.
WLX_SAS_ACTION_SHUTDOWN_SLEEP
 컴퓨터를 일시 중단 모드로 전환합니다.
WLX_SAS_ACTION_SHUTDOWN_SLEEP2
 시스템을 ACPI 전원 다운 상태로 종료합니다. 컴퓨터가 ACPI 컴퓨터가 아닌 경우 이 옵션은 아무런 영향을 주지 않습니다.
WLX_SAS_ACTION_SHUTDOWN_HIBERNATE
 시스템을 최대 절전 모드로 종료합니다. 시스템이 최대 절전 모드로 구성되지 않은 경우 이 옵션은 적용되지 않습니다.

설명

Winlogon은 로그온한 사용자가 워크스테이션을 종료, 로그아웃 또는 잠그려고 할 때 WlxLoggedOnSAS 를 호출합니다. GINA DLL은 WLX_SAS_ACTION_LOCK_WKSTA 반환하여 워크스테이션을 잠글 수 있습니다. 이 값이 반환되면 Winlogon 은 워크스테이션을 잠그고 다음에 SAS를 받을 때 WlxWkstaLockedSAS 를 호출합니다.

WlxLoggedOnSAS를 호출하기 전에 Winlogon은 현재 데스크톱이 Winlogon 데스크톱이 되도록 데스크톱 상태를 설정하고 데스크톱이 잠기도록 워크스테이션 상태를 설정합니다.

요구 사항

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

참고 항목

WlxInitialize

WlxWkstaLockedSAS