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 내에서 이 함수의 주소를 찾아야 합니다. GetProcAddress 호출에 실패하는 경우 대체 메커니즘을 사용하여 사용자 인터페이스 요소를 표시해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 이 함수는 Windows XP 이상에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | winsplp.h(Winsplp.h 포함) |
| 라이브러리 | 스풀스.lib |
| DLL | Spoolss.dll |