Funzione InstallPrinterDriverFromPackage

Articolo
06/12/2023

Installa un driver della stampante da un pacchetto driver che si trova nell'archivio driver del server di stampa.

Sintassi

HRESULT InstallPrinterDriverFromPackage(
  _In_ LPCTSTR pszServer,
  _In_ LPCTSTR pszInfPath,
  _In_ LPCTSTR pszDriverName,
  _In_ LPCTSTR pszEnvironment,
  _In_ DWORD   dwFlags
);

Parametri

pszServer [in]: Puntatore a una stringa costante con terminazione Null che specifica il nome del server di stampa. NULL indica il computer locale.
pszInfPath [in]: Puntatore a una stringa costante con terminazione Null che specifica il percorso dell'archivio driver del file inf del driver di stampa. NULL indica che il driver si trova in un file inf fornito con Windows.
pszDriverName [in]: Puntatore a una stringa costante con terminazione Null che specifica il nome del driver.
pszEnvironment [in]: Puntatore a una stringa costante con terminazione Null che specifica l'architettura del processore, ad esempio Windows NT x86. Può essere NULL.
dwFlags [in]: Può essere solo 0 o IPDFP_COPY_ALL_FILES. Il valore 0 indica che il driver della stampante deve essere aggiunto e tutti i file nella directory del driver della stampante più recenti rispetto ai file attualmente in uso devono essere copiati. Il valore IPDFP_COPY_ALL_FILES indica che è necessario aggiungere il driver della stampante e tutti i file nella directory del driver della stampante. I timestamp dei file vengono ignorati quando dwFlags ha un valore di IPDFP_COPY_ALL_FILES.

Valore restituito

Se l'operazione ha esito positivo, il valore restituito viene S_OK; in caso contrario , HRESULT conterrà un codice di errore.

Per altre informazioni sui codici di errore COM, vedere Gestione degli errori.

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.

L'archivio driver è in genere %windir%\inf o %windir%\System32\DriverStore\FileRepository.

InstallPrinterDriverFromPackage installa anche altri file nel pacchetto, ad esempio profili colore e processori di stampa.

Gli utenti devono disporre dei diritti di amministrazione della stampante per l'installazione in un computer remoto o nel computer locale quando l'utente ha effettuato l'accesso con Servizi terminal.

Solo i pacchetti firmati possono essere installati in un computer remoto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Spoolss.dll
Nomi Unicode e ANSI	InstallPrinterDriverFromPackageW (Unicode) e InstallPrinterDriverFromPackageA (ANSI)

Vedi anche

Stampa
Funzioni dell'API spooler di stampa

Share via