Funzione MergeAndValidatePrintTicketThunk2
[Questa funzione non è supportata e potrebbe essere disabilitata o eliminata nelle versioni future di Windows. PTMergeAndValidatePrintTicket offre funzionalità equivalenti e devono essere usate invece.
Unisce due biglietti di stampa e restituisce un biglietto di stampa valido e valida.
Sintassi
HRESULT MergeAndValidatePrintTicketThunk2(
_In_ HPTPROVIDER hProvider,
_In_ BYTE *pBasePrintTicket,
_In_ INT basePrintTicketLength,
_In_opt_ BYTE *pDeltaPrintTicket,
_In_ INT deltaPrintTicketLength,
_In_ DWORD scope,
_Out_ BYTE **ppValidatedPrintTicket,
_Out_ INT *pValidatedPrintTicketLength,
_Out_opt_ BSTR *pbstrErrorMessage
);
Parametri
-
hProvider [in]
-
Handle a un provider di ticket di stampa aperto. Questo handle viene restituito dalla funzione BindPTProviderThunk .
-
pBasePrintTicket [in]
-
Buffer contenente i dati del ticket di stampa di base, espressi in XML, come descritto nello schema di stampa.
-
basePrintTicketLength [in]
-
Dimensioni, in byte, del buffer a cui fa riferimento pBasePrintTicket.
-
pDeltaPrintTicket [in, facoltativo]
-
Buffer contenente il ticket di stampa da unire. I dati del ticket di stampa vengono espressi in XML, come descritto nello schema di stampa. Il valore di questo parametro può essere NULL.
-
deltaPrintTicketLength [in]
-
Dimensioni, in byte, del buffer a cui fa riferimento pDeltaPrintTicket.
-
ambito [in]
-
Valore che specifica se l'ambito di pDeltaPrintTicket e ppValidatedPrintTicket è una singola pagina, un intero documento o tutti i documenti nel processo di stampa. Il valore di questo parametro deve essere membro dell'enumerazione EPrintTicketScope , eseguire il cast come DWORD.
-
ppValidatedPrintTicket [out]
-
Indirizzo del buffer che contiene il ticket di stampa unito e convalidato. Questa funzione chiama CoTaskMemAlloc per allocare questo buffer. Quando il buffer non è più necessario, il chiamante deve liberarlo chiamando CoTaskMemFree.
-
pValidatedPrintTicketLength [out]
-
Dimensioni, in byte, del buffer a cui fa riferimento ppValidatedPrintTicket.
-
pbstrErrorMessage [out, facoltativo]
-
Puntatore a una stringa che specifica cosa, se presente, non è valido per il ticket di stampa in pBasePrintTicket o pDeltaPrintTicket. Se sono entrambi validi, questo valore è NULL. Se pbstrErrorMessage non è NULL quando la funzione restituisce, il chiamante deve liberare la stringa con SysFreeString.
Valore restituito
Se il metodo ha esito positivo, restituisce S_OK; in caso contrario, restituisce un codice di errore HRESULT . Per altre informazioni sui codici di errore COM, vedere Gestione degli errori.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| DLL |
|