SplIsSessionZero-Funktion (winsplp.h)

Artikel
02/07/2025

Die funktion SplIsSessionZero bestimmt, ob ein bestimmter Druckauftrag (Druckkästchen plus Auftrags-ID) in Sitzung nullausgegeben 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 FALSEfestgelegt.

Rückgabewert

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

Bemerkungen

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 die Darstellung von Benutzeroberflächenelementen in der Sitzung des Benutzers anstelle von Sitzung Null zu ermöglichen. Eine verwandte Funktion, SplPromptUIInUsersSession, zeigt ein standardmäßiges Windows-Meldungsfeld in der Sitzung des Benutzers an.

Wenn Sie beabsichtigen, diese Funktion in einem Treiber zu verwenden, 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 innerhalb dieser DLL durch einen Aufruf der GetProcAddress-Funktion suchen. Wenn der Aufruf von GetProcAddress fehlschlägt, müssen Sie einen alternativen Mechanismus verwenden, um Benutzeroberflächenelemente anzuzeigen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Diese Funktion ist in Windows XP und höher verfügbar.
Zielplattform-	Desktop
Header-	winsplp.h (include Winsplp.h)
Library	Spoolss.lib
DLL-	Spoolss.dll

Siehe auch

SplPromptUIInUsersSession

Freigeben über