Funzioni dell'API spooler di stampa

  • Articolo

L'API Spooler di stampa contiene le funzioni e le strutture di dati usate dalle applicazioni per gestire lo spooler di stampa di Windows e le stampanti e i processi di stampa che controlla.

Le funzioni dell'API Spooler di stampa sono suddivise nei gruppi seguenti:

Queste funzioni inviano processi di stampa a una stampante e tengono traccia e controllano i processi di stampa nello spooler di stampa.

Funzione Descrizione
AddJob
 La funzione AddJob aggiunge un processo di stampa all'elenco dei processi di stampa che possono essere pianificati dallo spooler di stampa. La funzione recupera il nome del file che è possibile usare per archiviare il processo.
ClosePrinter
 La funzione ClosePrinter chiude l'oggetto stampante specificato.
DocumentEvent
 La funzione DocumentEvent è un gestore eventi per gli eventi associati alla stampa di un documento.
Proprietà documento
 La funzione DocumentProperties recupera o modifica le informazioni di inizializzazione della stampante o visualizza una finestra delle proprietà di configurazione della stampante per la stampante specificata.
EndDocPrinter
 La funzione EndDocPrinter termina un processo di stampa per la stampante specificata.
EndPagePrinter
 La funzione EndPagePrinter notifica allo spooler di stampa che l'applicazione si trova alla fine di una pagina in un processo di stampa.
EnumJobs
 La funzione EnumJobs recupera informazioni su un set specificato di processi di stampa per una stampante specificata.
GetJob
 La funzione GetJob recupera informazioni su un processo di stampa specificato.
OpenPrinter
 La funzione OpenPrinter recupera un handle per la stampante o il server di stampa specificato o altri tipi di handle nel sottosistema di stampa.
OpenPrinter2
 Recupera un handle per la stampante, il server di stampa o altri tipi di handle nel sottosistema di stampa, impostando alcune delle opzioni della stampante.
ReportJobProcessingProgress
 Segnala al servizio Spooler di stampa se un processo di stampa XPS si trova nello spooling o nella fase di rendering e quale parte dell'elaborazione è attualmente in corso.
ScheduleJob
 La funzione ScheduleJob richiede che lo spooler di stampa pianifica un processo di stampa specificato per la stampa.
SetJob
 La funzione SetJob sospende, riprende, annulla o riavvia un processo di stampa su una stampante specificata. È anche possibile utilizzare la funzione SetJob per impostare i parametri del processo di stampa, ad esempio la priorità del processo di stampa e il nome del documento.
StartDocPrinter
 La funzione StartDocPrinter notifica allo spooler di stampa che un documento deve essere sottoposto a spooling per la stampa.
StartPagePrinter
 La funzione StartPagePrinter notifica allo spooler che una pagina sta per essere stampata nella stampante specificata.

Funzioni dell'interfaccia utente della stampante

Queste funzioni visualizzano un'interfaccia utente che consente all'utente di selezionare o configurare una stampante.

Funzione Descrizione
AdvancedDocumentProperties
 La funzione AdvancedDocumentProperties visualizza una finestra di dialogo di configurazione della stampante per la stampante specificata, consentendo all'utente di configurare la stampante.
ConfigurePort
 La funzione ConfigurePort visualizza la finestra di dialogo di configurazione della porta per una porta nel server specificato.
ConnectToPrinterDlg
 La funzione ConnectToPrinterDlg visualizza una finestra di dialogo che consente agli utenti di esplorare e connettersi alle stampanti in una rete. Se l'utente seleziona una stampante, la funzione tenta di crearvi una connessione; se nel server non è installato un driver appropriato, l'utente ha la possibilità di creare una stampante in locale.
PrinterProperties
 La funzione PrinterProperties visualizza una finestra delle proprietà della stampante per la stampante specificata.

Funzioni della stampante

Queste funzioni aggiungono e configurano le stampanti usate dallo spooler di stampa.

Funzione Descrizione
AbortPrinter
 La funzione AbortPrinter elimina il file di spooling di una stampante se la stampante è configurata per lo spooling.
Addprinter
 La funzione AddPrinter aggiunge una stampante all'elenco delle stampanti supportate per un server specificato.
AddPrinterConnection
 La funzione AddPrinterConnection aggiunge una connessione alla stampante specificata per l'utente corrente.
AddPrinterConnection2
 Aggiunge una connessione alla stampante specificata per l'utente corrente e specifica i dettagli di connessione.
DeletePrinter
 La funzione DeletePrinter elimina l'oggetto stampante specificato.
DeletePrinterConnection
 La funzione DeletePrinterConnection elimina una connessione a una stampante stabilita da una chiamata a AddPrinterConnection o ConnectToPrinterDlg.
DeletePrinterData
 La funzione DeletePrinterData elimina i dati di configurazione specificati per una stampante. I dati di configurazione di una stampante sono costituiti da un set di valori denominati e tipizzati. La funzione DeletePrinterData elimina uno di questi valori, specificato dal nome del valore.
DeletePrinterDataEx
 La funzione DeletePrinterDataEx elimina un valore specificato dai dati di configurazione per una stampante. I dati di configurazione di una stampante sono costituiti da un set di valori denominati e tipizzati archiviati in una gerarchia di chiavi del Registro di sistema. La funzione elimina un valore specificato in una chiave specificata.
DeletePrinterKey
 La funzione DeletePrinterKey elimina una chiave specificata e tutte le relative sottochiavi per una stampante specificata.
EnumPrinterData
 La funzione EnumPrinterData enumera i dati di configurazione per una stampante specificata.
EnumPrinterDataEx
 La funzione EnumPrinterDataEx enumera tutti i nomi di valore e i dati per una stampante e una chiave specificati.
EnumPrinterKey
 La funzione EnumPrinterKey enumera le sottochiavi di una chiave specificata per una stampante specificata.
Enumprinters
 La funzione EnumPrinters enumera stampanti, server di stampa, domini o provider di stampa disponibili.
FlushPrinter
 La funzione FlushPrinter invia un buffer alla stampante per cancellarlo da uno stato temporaneo.
GetDefaultPrinter
 La funzione GetDefaultPrinter recupera il nome della stampante predefinita per l'utente corrente nel computer locale.
GetPrinter
 La funzione GetPrinter recupera informazioni su una stampante specificata.
GetPrinterData
 La funzione GetPrinterData recupera i dati di configurazione per la stampante o il server di stampa specificati.
GetPrinterDataEx
 La funzione GetPrinterDataEx recupera i dati di configurazione per la stampante o il server di stampa specificati. GetPrinterDataEx può recuperare i valori archiviati dalla funzione SetPrinterData . Inoltre, GetPrinterDataEx può recuperare i valori archiviati in una chiave specificata dalla funzione SetPrinterDataEx .
IsValidDevmode
 La funzione IsValidDevmode verifica che il contenuto di una struttura DEVMODE sia valido.
ReadPrinter
 La funzione ReadPrinter recupera i dati dalla stampante specificata.
ResetPrinter
 La funzione ResetPrinter specifica i valori del tipo di dati e della modalità dispositivo da usare per la stampa di documenti inviati dalla funzione StartDocPrinter . Questi valori possono essere sottoposti a override usando la funzione SetJob dopo l'avvio della stampa dei documenti.
SetDefaultPrinter
 La funzione SetDefaultPrinter imposta il nome della stampante predefinita per l'utente corrente nel computer locale.
SetPort
 La funzione SetPort imposta lo stato associato a una porta della stampante.
Setprinter
 La funzione SetPrinter imposta i dati per una stampante specificata o imposta lo stato della stampante specificata sospendere la stampa, riprendere la stampa o cancellare tutti i processi di stampa.
SetPrinterData
 La funzione SetPrinterData imposta i dati di configurazione per una stampante o un server di stampa.
SetPrinterDataEx
 La funzione SetPrinterDataEx imposta i dati di configurazione per una stampante o un server di stampa. La funzione archivia i dati di configurazione sotto la chiave del Registro di sistema della stampante.
WritePrinter
 La funzione WritePrinter informa lo spooler di stampa che i dati devono essere scritti nella stampante specificata.

Funzioni di notifica delle modifiche della stampante

Queste funzioni consentono a un'applicazione di ricevere una notifica delle modifiche allo stato di una stampante.

Funzione Descrizione
FindClosePrinterChangeNotification
 La funzione FindClosePrinterChangeNotification chiude un oggetto di notifica di modifica creato chiamando la funzione FindFirstPrinterChangeNotification . La stampante o il server di stampa associati all'oggetto di notifica di modifica non verranno più monitorati da tale oggetto.
FindFirstPrinterChangeNotification
 La funzione FindFirstPrinterChangeNotification crea un oggetto di notifica di modifica e restituisce un handle all'oggetto. È quindi possibile usare questo handle in una chiamata a una delle funzioni di attesa per monitorare le modifiche apportate alla stampante o al server di stampa.
FindNextPrinterChangeNotification
 La funzione FindNextPrinterChangeNotification recupera informazioni sulla notifica di modifica più recente per un oggetto di notifica delle modifiche associato a una stampante o a un server di stampa. Chiamare questa funzione quando viene soddisfatta un'operazione di attesa nell'oggetto di notifica delle modifiche.
FreePrinterNotifyInfo
 La funzione FreePrinterNotifyInfo libera un buffer allocato dal sistema creato dalla funzione FindNextPrinterChangeNotification .

Funzioni modulo stampante

Queste funzioni gestiscono i moduli usati da una stampante.

Funzione Descrizione
AddForm
 La funzione AddForm aggiunge un modulo all'elenco di moduli disponibili che possono essere selezionati per la stampante specificata.
DeleteForm
 La funzione DeleteForm rimuove un nome di modulo dall'elenco dei moduli supportati.
EnumForms
 La funzione EnumForms enumForms enumera i moduli supportati dalla stampante specificata.
GetForm
 La funzione GetForm recupera informazioni su un modulo specificato.
SetForm
 La funzione SetForm imposta le informazioni del modulo per la stampante specificata.

Queste funzioni interagiscono con lo spooler di stampa a basso livello.

Funzione Descrizione
CloseSpoolFileHandle
 La funzione CloseSpoolFileHandle chiude un handle a un file di spool associato al processo di stampa attualmente inviato dall'applicazione.
CommitSpoolData
 La funzione CommitSpoolData informa lo spooler di stampa che una quantità specificata di dati è stata scritta in un file spool specificato ed è pronta per il rendering.
GetPrintExecutionData
 GetPrintExecutionData recupera il contesto di stampa corrente.
GetSpoolFileHandle
 La funzione GetSpoolFileHandle recupera un handle per il file di spool associato al processo attualmente inviato dall'applicazione.