WlxActivateUserShell 함수(winwlx.h)

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

사용자 셸 프로그램을 활성화합니다.

WlxActivateUserShell 함수는 대체 GINA DLL에 의해 구현되어야 합니다. Winlogon은 성공적인 로그온 후 이 함수를 호출하여 GINA가 사용자의 셸 프로그램을 활성화하도록 요청합니다.

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

 

구문

BOOL WlxActivateUserShell(
  [in] PVOID pWlxContext,
  [in] PWSTR pszDesktopName,
  [in] PWSTR pszMprLogonScript,
  [in] PVOID pEnvironment
);

매개 변수

[in] pWlxContext

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

[in] pszDesktopName

셸이 시작될 바탕 화면의 이름을 지정하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. STARTUPINFO 구조체의 lpDesktop 멤버를 통해 이 문자열을 CreateProcess 또는 CreateProcessAsUser 함수에 전달합니다.

[in] pszMprLogonScript

네트워크 공급자 DLL에서 반환된 스크립트 이름을 지정하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 네트워크 공급자 DLL은 로그온하는 동안 실행할 스크립트를 반환할 수 있습니다. 그러나 GINA는 이를 무시할 수 있습니다.

[in] pEnvironment

프로세스의 초기 환경 변수를 지정합니다. Winlogon은 환경의 복사본을 만들어 GINA에 건네 냅니다. GINA는 이 환경을 사용하여 사용자의 셸을 초기화하기 전에 이 환경을 수정할 수 있습니다. GINA는 VirtualFree 함수를 호출하여 pEnvironment에 할당된 메모리를 해제해야 합니다.

반환 값

함수가 셸 프로세스를 성공적으로 시작하면 함수는 TRUE를 반환 합니다.

함수가 실패하면 FALSE를 반환합니다. FALSE가 반환되면 Winlogon은 프로세스에서 로그온을 취소합니다.

설명

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

항상 WlxLoggedOutSAS가 아닌 WlxActivateUserShell에서 사용자 셸 프로그램을 활성화합니다. 이를 통해 Winlogon은 로그온한 사용자 프로세스를 실행하기 전에 워크스테이션 및 데스크톱 보호 설정을 포함하여 상태를 업데이트할 수 있습니다.

요구 사항

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

참고 항목

WlxInitialize

WlxLoggedOutSAS

WlxLogoff