次の方法で共有


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