다음을 통해 공유

PWLX_DIALOG_BOX 콜백 함수(winwlx.h)

  • 아티클

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

대화 상자 템플릿에서 모달 대화 상자를 만들기 위해 GINA 에서 호출됩니다.

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

구문

PWLX_DIALOG_BOX PwlxDialogBox;

int PwlxDialogBox(
  [in] HANDLE hWlx,
  [in] HANDLE hInst,
  [in] LPWSTR lpszTemplate,
  [in] HWND hwndOwner,
  [in] DLGPROC dlgprc
)
{...}

매개 변수

[in] hWlx

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

[in] hInst

실행 파일에 대화 상자 템플릿이 포함된 모듈의 instance 지정합니다.

[in] lpszTemplate

대화 상자 템플릿을 지정합니다. 이 매개 변수는 대화 상자 템플릿의 이름을 지정하는 null로 끝나는 문자열의 주소 또는 대화 상자 템플릿의 리소스 식별자를 지정하는 정수 값입니다. 매개 변수가 리소스 식별자를 지정하는 경우 해당 상위 단어는 0이어야 하며 하위 단어에는 식별자가 포함되어야 합니다. MAKEINTRESOURCE 매크로를 사용하여 이 값을 만들 수 있습니다.

[in] hwndOwner

대화 상자를 소유하는 창을 지정합니다.

[in] dlgprc

대화 상자 프로시저를 가리킵니다. 대화 상자 프로시저에 대한 자세한 내용은 DialogProc 콜백 함수를 참조하세요.

반환 값

WlxDialogBox 함수가 성공하면 반환 값은 대화 상자를 종료하는 데 사용되는 EndDialog 함수 호출에 지정된 nResult 매개 변수입니다. 다음 표에는 몇 가지 가능한 성공 반환 값이 나와 있습니다.

반환 코드 설명
WLX_DLG_INPUT_TIMEOUT
 입력 시간이 초과되었습니다.
WLX_DLG_SAS
 SAS( 보안 주의 시퀀스 ) 이벤트가 발생했습니다.
WLX_DLG_SCREEN_SAVER_TIMEOUT
 화면 보호기가 시간 초과되었습니다.
WLX_DLG_USER_LOGOFF
 사용자가 로그오프했습니다.
 

함수가 실패하면 반환 값은 –1입니다.

설명

GINA는 Windows DialogBox 매크로가 아닌 Winlogon WlxDialogBox 함수를 사용해야 합니다. WlxDialogBox 는 Windows DialogBox 매크로를 복제하고 Winlogon이 대화 상자를 종료하도록 허용합니다. 자세한 내용은 DialogBox를 참조하세요.

요구 사항

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

추가 정보

DialogBox

DialogProc

EndDialog

MAKEINTRESOURCE

WlxInitialize