Funzione SplIsSessionZero (winsplp.h)

  • Articolo

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

Vedi anche

SplPromptUIInUsersSession