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 |