Funzione UploadPrinterDriverPackage

Articolo
06/13/2023

Carica un driver della stampante nell'archivio driver del server di stampa in modo che possa essere installato chiamando InstallPrinterDriverFromPackage.

Sintassi

HRESULT UploadPrinterDriverPackage(
  _In_    LPCTSTR pszServer,
  _In_    LPCTSTR pszInfPath,
  _In_    LPCTSTR pszEnvironment,
  _In_    DWORD   dwFlags,
  _In_    HWND    hwnd,
  _Out_   LPTSTR  pszDestInfPath,
  _Inout_ PULONG  pcchDestInfPath
);

Parametri

pszServer [in]

Puntatore a una stringa costante con terminazione Null che specifica il nome del server di stampa. Utilizzare NULL se il server è il computer locale.

pszInfPath [in]

Puntatore a una stringa costante con terminazione Null che specifica il percorso di origine del file inf del driver.

pszEnvironment [in]

Puntatore a una stringa costante con terminazione Null che specifica l'architettura del processore del server, ad esempio Windows NT x86. Può essere NULL.

dwFlags [in]

Può trattarsi di uno dei valori seguenti:

Valore	Significato
UPDP_SILENT_UPLOAD	L'interfaccia utente non verrà visualizzata durante il caricamento.
UPDP_UPLOAD_ALWAYS	I file verranno caricati anche se il pacchetto si trova già nell'archivio driver del server.
UPDP_CHECK_DRIVERSTORE	L'archivio driver del server verrà controllato prima del caricamento per verificare se il pacchetto è già presente. Questa impostazione viene ignorata se è impostata UPDP_UPLOAD_ALWAYS.

hwnd [in]

Handle per la copia dell'interfaccia utente.

pszDestInfPath [out]

Puntatore al percorso di destinazione, nell'archivio driver, in cui è stato copiato il file inf del driver.

pcchDestInfPath [in, out]

In input, specifica le dimensioni, in caratteri, del buffer pszDestInfPath . Nell'output, riceve le dimensioni, in caratteri, della stringa di percorso, incluso il carattere null di terminazione.

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.

È possibile caricare un solo pacchetto alla volta. Se un pacchetto dipende da altri utenti, deve essere caricato separatamente.

È possibile caricare solo i pacchetti driver firmati.

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	UploadPrinterDriverPackageW (Unicode) e UploadPrinterDriverPackageA (ANSI)

Vedi anche

Stampa
Funzioni dell'API spooler di stampa

Condividi tramite