SplIsSessionZero 함수(winsplp.h)

이 함수는 SplIsSessionZero 특정 인쇄 작업(인쇄 핸들 및 작업 ID)이 세션 0에서 실행되었는지 여부를 결정합니다.

구문

DWORD SplIsSessionZero(
  [in]  HANDLE hPrinter,
        DWORD  JobId,
  [out] BOOL   *pIsSessionZero
);

매개 변수

[in] hPrinter

프린터의 핸들입니다.

JobId

[out] pIsSessionZero

세션의 SessionID가 0이면 TRUE 로 설정된 메모리 위치에 대한 포인터입니다. 그렇지 않으면 이 값이 FALSE로 설정됩니다.

반환 값

성공하면 함수는 SplIsSessionZero ERROR_SUCCESS 반환하고, 그렇지 않으면 이 함수는 Win32 오류 코드를 반환합니다.

설명

사용자 지정 사용자 인터페이스 요소를 표시하는 드라이버는 이 함수를 SplIsSessionZero 사용하여 세션 0에서 현재 작업이 실행되었는지 여부를 확인할 수 있습니다. 이러한 드라이버는 이 정보를 사용하여 세션 0이 아닌 사용자 세션에 사용자 인터페이스 요소를 표시할 수 있습니다. 관련 함수인 SplPromptUIInUsersSession은 사용자의 세션에 표준 Windows 메시지 상자를 표시합니다.

Windows 2000에서 실행하려는 드라이버에서 이 함수를 사용하려는 경우 LoadLibrary 함수를 호출하여 spoolss.dll 로드한 다음 GetProcAddress 함수를 호출하여 해당 DLL 내에서 이 함수의 주소를 찾아야 합니다. (LoadLibrary 및 GetProcAddress는 Microsoft Windows SDK 설명서에 설명되어 있습니다.) GetProcAddress 호출이 실패하는 경우 대체 메커니즘을 사용하여 사용자 인터페이스 요소를 표시해야 합니다.

요구 사항

지원되는 최소 클라이언트	이 함수는 Windows XP 이상에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
헤더	winsplp.h(Winsplp.h 포함)
라이브러리	Spoolss.lib
DLL	Spoolss.dll

참고 항목

SplPromptUIInUsersSession