SplIsSessionZero 関数 (winsplp.h)
SplIsSessionZero 関数は、セッション 0 で特定の印刷ジョブ (印刷ハンドルとジョブ ID)発行されたかどうかを判断します。
構文
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 を含む) |
ライブラリ | Spoolss.lib |
DLL | Spoolss.dll |
関連項目
SplPromptUIInUsersSession の