Funzioni dell'API spooler di stampa

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:

• Funzioni del processo di stampa
• Funzioni dell'interfaccia utente della stampante
• Funzioni della stampante
• Funzioni di notifica delle modifiche della stampante
• Funzioni modulo stampante
• Funzioni Spooler di stampa

Funzioni del processo di stampa

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.

Stampa di funzioni Spooler

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.