Funzione PTConvertDevModeToPrintTicket (prntvpt.h)

Articolo
03/15/2023

Converte una struttura DEVMODE in un ticket di stampa all'interno di un IStream.

Sintassi

HRESULT PTConvertDevModeToPrintTicket(
  [in] HPTPROVIDER       hProvider,
       ULONG             cbDevmode,
  [in] PDEVMODE          pDevmode,
  [in] EPrintTicketScope scope,
       IStream           *pPrintTicket
);

Parametri

[in] hProvider

Handle a un provider di ticket di stampa aperto. Questo handle viene restituito dalla funzione PTOpenProvider o PTOpenProviderEx.

cbDevmode

Dimensioni di DEVMODE in byte.

[in] pDevmode

Puntatore a DEVMODE.

[in] scope

Valore che specifica l'ambito di pPrintTicket. Questo valore può specificare una singola pagina, un intero documento o tutti i documenti nel processo di stampa. Le impostazioni in pDevmode esterne all'ambito specificato non verranno incluse in pPrintTicket. Vedere la sezione Osservazioni.

pPrintTicket

Puntatore a un IStream con la sua posizione di ricerca all'inizio del biglietto di stampa.

Valore restituito

Se l'operazione ha esito positivo, il valore restituito è S_OK, in caso contrario, HRESULT contiene un codice di errore.

Se hProvider è stato aperto in un thread diverso, HRESULT è E_INVALIDARG.

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.

hProvider deve essere un handle aperto nello stesso thread del thread in cui viene usato per questa funzione.

Se pDevmode punta a una stampante diversa, le impostazioni potrebbero essere perse e sostituite con le impostazioni predefinite.

Le impostazioni in pDevmode esterne all'ambito non sono incluse in pPrintTicket. Ad esempio, se l'ambito è una singola pagina, le impostazioni a livello di processo e le impostazioni a livello di documento non sono incluse. Un ambito del processo include ambito documento e ambito pagina. Un ambito documento include l'ambito della pagina.

PTConvertDevModeToPrintTicket scrive il ticket di stampa in IStream a cui fa riferimento pPrintTicket a partire dal punto di ricerca corrente del flusso. Dopo che PTConvertDevModeToPrintTicket restituisce , il chiamante deve reimpostare il punto di ricerca iniziale per leggere il ticket di stampa restituito dalla funzione.

Requisiti


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

Condividi tramite