Funzione SplIsSessionZero (winsplp.h)
La funzione SplIsSessionZero determina se un determinato processo di stampa (handle di stampa più ID processo) è stato emesso in sessione zero.
Sintassi
DWORD SplIsSessionZero(
[in] HANDLE hPrinter,
DWORD JobId,
[out] BOOL *pIsSessionZero
);
Parametri
[in] hPrinter
Handle per la stampante.
JobId
Specifica il processo di stampa.
[out] pIsSessionZero
Puntatore a una posizione di memoria impostata su TRUE se SessionID per la sessione è zero; in caso contrario, questo valore è impostato su FALSE.
Valore restituito
In caso di esito positivo, la funzione SplIsSessionZero restituisce ERROR_SUCCESS; in caso contrario, questa funzione restituisce un codice di errore Win32.
Osservazioni
Un driver che visualizza elementi dell'interfaccia utente personalizzati può usare la funzione SplIsSessionZero per determinare se il processo corrente è stato emesso nella sessione 0. Un driver di questo tipo può usare queste informazioni per abilitarlo per presentare gli elementi dell'interfaccia utente nella sessione dell'utente, anziché nella sessione zero. Una funzione correlata, SplPromptUIInUsersSession, visualizza una finestra di messaggio standard di Windows nella sessione dell'utente.
Se si prevede di usare questa funzione in un driver destinato all'esecuzione in Windows 2000, è necessario caricare spoolss.dll tramite una chiamata alla funzione LoadLibrary e quindi trovare l'indirizzo di questa funzione all'interno di tale DLL tramite una chiamata alla funzione GetProcAddress. Se la chiamata a GetProcAddress ha esito negativo, è necessario usare un meccanismo alternativo per visualizzare gli elementi dell'interfaccia utente.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Questa funzione è disponibile in Windows XP e versioni successive. |
| piattaforma di destinazione | Desktop |
| intestazione | winsplp.h (includere Winsplp.h) |
| libreria | Spoolss.lib |
| dll | Spoolss.dll |