SplIsSessionZero-Funktion (winsplp.h)

Die SplIsSessionZero-Funktion bestimmt, ob ein bestimmter Druckauftrag (Druckhandle plus Auftrags-ID) in Sitzungsnull ausgegeben wurde.

Syntax

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

Parameter

[in] hPrinter

Ein Ziehpunkt für den Drucker.

JobId

Gibt den Druckauftrag an.

[out] pIsSessionZero

Zeiger auf einen Speicherspeicherort, der auf TRUE festgelegt ist, wenn die SessionID für die Sitzung null ist; Andernfalls wird dieser Wert auf FALSE festgelegt.

Rückgabewert

Bei Erfolg gibt die SplIsSessionZero-Funktion ERROR_SUCCESS zurück. Andernfalls gibt diese Funktion einen Win32-Fehlercode zurück.

Hinweise

Ein Treiber, der benutzerdefinierte Benutzeroberflächenelemente anzeigt, kann die SplIsSessionZero-Funktion verwenden, um zu bestimmen, ob der aktuelle Auftrag in Sitzung 0 ausgestellt wurde. Ein solcher Treiber kann diese Informationen verwenden, um Benutzeroberflächenelemente in der Sitzung des Benutzers und nicht in Sitzungsnull darzustellen. Die zugehörige Funktion SplPromptUIInUsersSession zeigt ein Standardmäßiges Windows-Meldungsfeld in der Sitzung des Benutzers an.

Wenn Sie diese Funktion in einem Treiber verwenden möchten, der unter Windows 2000 ausgeführt werden soll, müssen Sie spoolss.dll durch einen Aufruf der LoadLibrary-Funktion laden und dann die Adresse dieser Funktion in dieser DLL durch einen Aufruf der GetProcAddress-Funktion suchen. Wenn der Aufruf von GetProcAddress fehlschlägt, müssen Sie einen alternativen Mechanismus zum Anzeigen von Benutzeroberflächenelementen verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Diese Funktion ist in Windows XP und höher verfügbar.
Zielplattform	Desktop
Kopfzeile	winsplp.h (winsplp.h einschließen)
Bibliothek	Spoolss.lib
DLL	Spoolss.dll

Weitere Informationen

SplPromptUIInUsersSession