Funzione AddPrintProcessor

La funzione AddPrintProcessor installa un processore di stampa nel server specificato e aggiunge il nome del processore di stampa all'elenco dei processori di stampa supportati.

Sintassi

BOOL AddPrintProcessor(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pPathName,
  _In_ LPTSTR pPrintProcessorName
);

Parametri

pName [in]

Puntatore a una stringa con terminazione Null che specifica il nome del server in cui deve essere installato il processore di stampa. Se questo parametro è NULL, il processore di stampa viene installato in locale.

pEnvironment [in]

Puntatore a una stringa con terminazione Null che specifica l'ambiente (ad esempio, Windows x86, Windows IA64 o Windows x64). Se questo parametro è NULL, viene usato l'ambiente corrente del chiamante/client (non della destinazione/server).

pPathName [in]

Puntatore a una stringa con terminazione Null che specifica il nome del file che contiene il processore di stampa. Questo file deve trovarsi nella directory del processore di stampa di sistema.

pPrintProcessorName [in]

Puntatore a una stringa con terminazione Null che specifica il nome del processore di stampa.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Nota

Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità di restituzione di questa funzione dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. Chiamando questa funzione da un thread che gestisce l'interazione con l'interfaccia utente, l'applicazione potrebbe sembrare non rispondente.

Il chiamante deve avere SeLoadDriverPrivilege.

Prima di chiamare la funzione AddPrintProcessor , un'applicazione deve verificare che il file contenente il processore di stampa sia archiviato nella directory del processore di stampa di sistema. Un'applicazione può recuperare il nome della directory del processore di stampa di sistema chiamando la funzione GetPrintProcessorDirectory .

Un'applicazione può determinare il nome dei processori di stampa esistenti chiamando la funzione EnumPrintProcessors .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Winspool.drv
Nomi Unicode e ANSI	AddPrintProcessorW (Unicode) e AddPrintProcessorA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

EnumPrintProcessors

GetPrintProcessorDirectory