Funzione PTOpenProviderEx (prntvpt.h)

Articolo
08/25/2023

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

Sintassi

HRESULT PTOpenProviderEx(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwMaxVersion,
        DWORD       dwPrefVersion,
  [out] HPTPROVIDER *phProvider,
  [out] DWORD       *pUsedVersion
);

Parametri

[in] pszPrinterName

Puntatore al nome completo di una coda di stampa.

dwMaxVersion

La versione più recente dello schema di stampa supportata dal chiamante.

dwPrefVersion

Versione dello schema di stampa richiesta dal chiamante.

[out] phProvider

Puntatore a un handle per il provider.

[out] pUsedVersion

Puntatore alla versione dello schema di stampa che verrà utilizzato dal provider di ticket di stampa.

Valore restituito

Se l'operazione ha esito positivo, il valore restituito viene 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à di restituzione di questa funzione dipende da fattori di runtime, ad esempio lo stato della rete, la configurazione del server di stampa e l'implementazione del driver della stampante, fattori 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 parametro pszPrinterName deve essere il nome completo, non il nome troncato come potrebbe apparire in devMODE.

La prima versione dello schema di stampa è stata rilasciata con Windows Vista ed è la versione 1. Se il provider di ticket di stampa non supporta prefVersion, PTOpenProviderEx apre correttamente un handle e restituisce una versione precedente in usedVersion.

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

Stampa schema

Funzioni dell'API spooler di stampa

Stampa

Condividi tramite