WlxInitialize 함수(winwlx.h)

  • 아티클

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

WlxInitialize 함수는 대체 GINA DLL에 의해 구현되어야 합니다. Winlogon은 컴퓨터에 있는 각 창 스테이션에 대해 이 함수를 한 번 호출합니다. 현재 운영 체제는 워크스테이션당 하나의 창 스테이션을 지원합니다.

참고 GINA DLL은 Windows Vista에서 무시됩니다.
 
이 함수에서 반환된 컨텍스트 는 모든 후속 호출에서 GINA로 다시 전달됩니다.

구문

BOOL WlxInitialize(
  [in]  LPWSTR lpWinsta,
  [in]  HANDLE hWlx,
  [in]  PVOID  pvReserved,
  [in]  PVOID  pWinlogonFunctions,
  [out] PVOID  *pWlxContext
);

매개 변수

[in] lpWinsta

초기화되는 창 스테이션의 이름에 대한 포인터입니다.

[in] hWlx

Winlogon에 대한 핸들입니다. GINA는 이 창 스테이션을 포함하는 Winlogon 지원 함수에 대한 모든 호출에서 이 핸들을 제공해야 합니다.

[in] pvReserved

이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL로 설정해야 합니다.

[in] pWinlogonFunctions

Winlogon 지원 함수 디스패치 테이블에 대한 포인터입니다. 테이블의 내용은 WlxNegotiate 호출에서 반환된 GINA DLL 버전에 따라 달라집니다. 이 테이블은 변경되지 않으므로 GINA DLL에서 테이블을 복사하지 않고도 참조할 수 있습니다. GINA DLL이 테이블의 복사본을 만들어야 하는 경우 WlxGetOption 을 호출하고 Option 매개 변수에 대한 WLX_OPTION_DISPATCH_TABLE_SIZE 제공해야 합니다.

값 의미
WLX_DISPATCH_VERSION_1_4
 Winlogon 디스패치 테이블 - 버전 1.4
WLX_DISPATCH_VERSION_1_3
 Winlogon 디스패치 테이블 - 버전 1.3
WLX_DISPATCH_VERSION_1_2
 Winlogon 디스패치 테이블 - 버전 1.2
WLX_DISPATCH_VERSION_1_1
 Winlogondispatch 테이블 - 버전 1.1
WLX_DISPATCH_VERSION_1_0
 Winlogon 디스패치 테이블 - 버전 1.0

[out] pWlxContext

이 창 스테이션에 대한 GINA 컨텍스트의 주소를 포함할 VOID 에 대한 포인터에 대한 포인터입니다. 이 컨텍스트는 Winlogon에서 GINA에 대한 모든 후속 호출에서 전달됩니다. GINA DLL은 컨텍스트에서 사용하는 모든 메모리를 관리합니다. 컨텍스트 포인터는 WLX_OPTION_CONTEXT_POINTER 사용하여 WlxSetOption 함수를 호출하여 나중에 변경할 수 있습니다.

반환 값

함수가 GINA DLL을 성공적으로 초기화하면 함수는 TRUE를 반환합니다.

함수가 실패하거나 GINA DLL이 초기화되지 않은 경우 함수는 FALSE를 반환합니다. Winlogon이 종료되고 시스템이 부팅되지 않습니다.

설명

WlxInitialize 는 컴퓨터에 있는 각 창 스테이션에 대해 한 번 호출됩니다.

현재 Winsta0이라는 단일 창 스테이션만 지원됩니다.

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

요구 사항

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

추가 정보

WlxNegotiate