Condividi tramite


Funzioni 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:

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 funzioneAddJobaggiunge 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 funzioneDocumentEventè un gestore eventi per gli eventi associati alla stampa di un documento.
DocumentProperties
La funzionedocumentPropertiesrecupera o modifica le informazioni di inizializzazione della stampante o visualizza una finestra delle proprietà di configurazione della stampante per la stampante specificata.
EndDocPrinter
La funzioneEndDocPrintertermina un processo di stampa per la stampante specificata.
EndPagePrinter
La funzioneEndPagePrinter notifica al spooler di stampa che l'applicazione si trova alla fine di una pagina in un processo di stampa.
EnumJobs
La funzioneEnumJobsrecupera informazioni su un set specificato di processi di stampa per una stampante specificata.
GetJob
La funzioneGetJobrecupera 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 sulla 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 funzioneConfigurePortvisualizza la finestra di dialogo di configurazione della porta per una porta nel server specificato.
ConnectToPrinterDlg
La funzioneConnectToPrinterDlgvisualizza 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 creare una connessione; se nel server non è installato un driver appropriato, all'utente viene assegnata 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 funzioneAddPrinteraggiunge 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 funzioneDeletePrinterConnectionelimina una connessione a una stampante stabilita da una chiamata a AddPrinterConnection o ConnectToPrinterDlg.
DeletePrinterData
La funzioneDeletePrinterDataelimina 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 e i dati dei valori 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 funzioneFlushPrinterinvia un buffer alla stampante per cancellarla da uno stato temporaneo.
GetDefaultPrinter
La funzione GetDefaultPrinter recupera il nome della stampante predefinita per l'utente corrente nel computer locale.
GetPrinter
La funzioneGetPrinterrecupera informazioni su una stampante specificata.
GetPrinterData
La funzioneGetPrinterDatarecupera i dati di configurazione per la stampante o il server di stampa specificato.
GetPrinterDataEx
La funzione GetPrinterDataEx recupera i dati di configurazione per la stampante o il server di stampa specificato. GetPrinterDataEx può recuperare i valori archiviati dalla funzioneSetPrinterData. 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 funzioneReadPrinterrecupera i dati dalla stampante specificata.
ResetPrinter
La funzioneResetPrinterspecifica i valori del tipo di dati e della modalità dispositivo da utilizzare per la stampa di documenti inviati dalla funzione StartDocPrinter. È possibile eseguire l'override di questi valori usando la funzionesetjobdopo 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 funzioneSetPortimposta 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 sospendo la stampa, riprendendo la stampa o cancellando tutti i processi di stampa.
SetPrinterData
La funzioneSetPrinterDataimposta 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 nella chiave del Registro di sistema della stampante.
WritePrinter
La funzione WritePrinter notifica allo 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 apportate allo stato di una stampante.

Funzione Descrizione
FindClosePrinterChangeNotification
La funzione FindClosePrinterChangeNotification chiude un oggetto notifica delle modifiche creato chiamando la funzioneFindFirstPrinterChangeNotification. La stampante o il server di stampa associato all'oggetto di notifica delle modifiche non verranno più monitorati da tale oggetto.
FindFirstPrinterChangeNotification
La funzione FindFirstPrinterChangeNotification crea un oggetto notifica delle modifiche e restituisce un handle all'oggetto . È quindi possibile utilizzare 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 delle modifiche più recente per un oggetto notifica di modifica associato a una stampante o a un server di stampa. Chiamare questa funzione quando viene soddisfatta un'operazione di attesa sull'oggetto di notifica delle modifiche.
FreePrinterNotifyInfo
La funzioneFreePrinterNotifyInfolibera un buffer allocato dal sistema creato dalla funzioneFindNextPrinterChangeNotification.

Funzioni modulo stampante

Queste funzioni gestiscono i moduli utilizzati da una stampante.

Funzione Descrizione
AddForm
La funzioneAddFormaggiunge un modulo all'elenco dei moduli disponibili che è possibile selezionare per la stampante specificata.
DeleteForm
La funzione DeleteForm rimuove un nome di modulo dall'elenco dei moduli supportati.
EnumForms
La funzione EnumForms enumera i moduli supportati dalla stampante specificata.
GetForm
La funzioneGetFormrecupera informazioni su un modulo specificato.
SetForm
La funzione SetForm imposta le informazioni sul modulo per la stampante specificata.

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

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