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 |
|
| Libreria |
|
| DLL |
|
| Nomi Unicode e ANSI |
AddPrintProcessorW (Unicode) e AddPrintProcessorA (ANSI) |