Funzione SplIsSessionZero (winsplp.h)
La funzione SplIsSessionZero determina se un determinato processo di stampa (handle di stampa più ID processo) è stato rilasciato 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.
Commenti
Un driver che visualizza elementi dell'interfaccia utente personalizzati può usare la funzione SplIsSessionZero per determinare se il processo corrente è stato rilasciato nella sessione 0. Tale driver può usare queste informazioni per abilitarlo per presentare gli elementi dell'interfaccia utente nella sessione dell'utente, anziché in sessione zero. Una funzione correlata, SplPromptUIInUsersSession, visualizza una finestra di messaggio di Windows standard nella sessione dell'utente.
Se si prevede di usare questa funzione in un driver destinato a essere eseguito in Windows 2000, è necessario caricare spoolss.dll da 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Questa funzione è disponibile in Windows XP e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Intestazione | winsplp.h (include Winsplp.h) |
| Libreria | Spoolss.lib |
| DLL | Spoolss.dll |