Funzione ConvertPrintTicketToDevModeThunk2
[Questa funzione non è supportata e potrebbe essere disabilitata o eliminata nelle versioni future di Windows. PTConvertPrintTicketToDevMode offre funzionalità equivalenti e deve essere invece usata.]
Converte un ticket di stampa in una struttura DEVMODE .
Sintassi
HRESULT ConvertPrintTicketToDevModeThunk2(
_In_ HPTPROVIDER hProvider,
_In_ BYTE *pPrintTicket,
_In_ ULONG cbSize,
_In_ INT baseType,
_In_ DWORD scope,
_Out_ BYTE **ppDevmode,
_Out_ ULONG *pcbDevModeLength,
_Out_opt_ BSTR *errMsg
);
Parametri
-
hProvider [in]
-
Handle per un provider di ticket di stampa aperto. Questo handle viene restituito dalla funzione BindPTProviderThunk .
-
pPrintTicket [in]
-
Buffer contenente il ticket di stampa da convertire.
-
cbSize [in]
-
Dimensione, in byte, del buffer passato in pPrintTicket.
-
baseType [in]
-
Valore che indica se l'impostazione DEVMODE predefinita dell'utente o la coda di stampa devMODE predefinita viene usata per fornire valori all'output DEVMODE quando pPrintTicket non specifica tutte le possibili impostazioni per devMODE. Il valore di questo parametro deve essere un membro dell'enumerazione EDefaultDevmodeType , eseguito il cast come INT.
-
ambito [in]
-
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. Il valore di questo parametro deve essere un membro dell'enumerazione EPrintTicketScope , eseguito il cast come DWORD.
-
ppDevmode [out]
-
Indirizzo del devMODE appena creato. Questa funzione chiama CoTaskMemAlloc per allocare questo buffer. Quando il buffer non è più necessario, il chiamante deve liberarlo chiamando CoTaskMemFree.
-
pcbDevModeLength [out]
-
Dimensioni, in byte, di DEVMODE restituite in ppDevmode.
-
errMsg [out, facoltativo]
-
Puntatore a una stringa che specifica cosa, se presente, non è valido per il ticket di stampa in pPrintTicket. Se è valido, questo valore è NULL. Se errMsg non è NULL quando la funzione viene restituita, 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 |
|