Funzione PTOpenProvider (prntvpt.h)

  • Articolo

Apre un'istanza di un provider di ticket di stampa.

Sintassi

HRESULT PTOpenProvider(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwVersion,
  [out] HPTPROVIDER *phProvider
);

Parametri

[in] pszPrinterName

Puntatore al nome completo di una coda di stampa.

dwVersion

Versione dello schema di stampa richiesta dal chiamante.

[out] phProvider

Puntatore a un handle per il provider.

Valore restituito

Se l'operazione ha esito positivo, il valore restituito è S_OK, in caso contrario, HRESULT contiene 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à con cui questa funzione restituisce dipende da fattori di runtime, ad esempio lo stato di rete, la configurazione del server di stampa e l'implementazione del driver della stampante, fattori difficili da prevedere durante la scrittura di un'applicazione. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.
 
pszPrinterName deve essere il nome completo, non il nome troncato come può essere visualizzato in un DEVMODE.

La prima versione dello schema di stampa è stata rilasciata con Windows Vista ed è la versione 1. Questa operazione ha esito negativo se la versione non è supportata. Contrasto con PTOpenProviderEx che apre un provider anche se supporta solo le versioni precedenti alla richiesta.

Per evitare una perdita di risorse, phProvider deve essere chiuso con PTCloseProvider.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione prntvpt.h
Libreria Prntvpt.lib
DLL Prntvpt.dll

Vedi anche

Schema di stampa

Funzioni dell'API spooler di stampa

Stampa