PWLX_SET_RETURN_DESKTOP 콜백 함수(winwlx.h)

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

GINA에서 호출하여 현재 SAS(보안 주의 순서) 이벤트 처리 함수가 완료될 때 Winlogon이 전환할 대체 애플리케이션 데스크톱을 지정합니다.

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

 

구문

PWLX_SET_RETURN_DESKTOP PwlxSetReturnDesktop;

BOOL PwlxSetReturnDesktop(
  [in] HANDLE hWlx,
  [in] PWLX_DESKTOP pDesktop
)
{...}

매개 변수

[in] hWlx

WlxInitialize 호출에서 GINA에 전달된 Winlogon 핸들을 지정합니다.

[in] pDesktop

대체 데스크톱에 대한 데스크톱 정보에 대한 포인터입니다. 이 데스크톱은 WlxCreateUserDesktop 함수를 호출하여 만듭니다.

반환 값

WlxSetReturnDesktop 함수는 다음 값 중 하나를 반환합니다.

반환 코드	설명
TRUE	함수 호출에 성공했습니다.
FALSE	함수 호출이 반환 데스크톱을 설정하지 못했습니다.

설명

WlxSetReturnDesktop 은 WlxLoggedOnSAS 또는 WlxWkstaLockedSAS 루틴 내에서만 호출할 수 있습니다. 다른 시간에 이 함수를 호출하려고 하면 실패합니다.

바탕 화면에 대한 핸들이 제공되면 Winlogon은 핸들을 복제합니다. 핸들이 제공되지 않으면 Winlogon은 pDesktop 매개 변수에서 라는 데스크톱을 열려고 시도합니다. 제공된 데스크톱이 유효하지 않거나 Winlogon 또는 화면 보호기 데스크톱인 경우 호출이 실패합니다.

요구 사항

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

참고 항목

WlxCreateUserDesktop

WlxInitialize

WlxLoggedOnSAS

WlxWkstaLockedSAS