Fonction ConvertPrintTicketToDevModeThunk2
[Cette fonction n’est pas prise en charge et peut être désactivée ou supprimée dans les versions ultérieures de Windows. PTConvertPrintTicketToDevMode fournit des fonctionnalités équivalentes et doit être utilisé à la place.]
Convertit un ticket d’impression en structure DEVMODE .
Syntaxe
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
);
Paramètres
-
hProvider [in]
-
Handle pour un fournisseur de ticket d’impression ouvert. Ce handle est retourné par la fonction BindPTProviderThunk .
-
pPrintTicket [in]
-
Mémoire tampon qui contient le ticket d’impression à convertir.
-
cbSize [in]
-
Taille, en octets, de la mémoire tampon passée dans pPrintTicket.
-
baseType [in]
-
Valeur indiquant si le DEVMODE par défaut de l’utilisateur ou le DEVMODE par défaut de la file d’attente d’impression est utilisé pour fournir des valeurs au DEVMODE de sortie lorsque pPrintTicket ne spécifie pas tous les paramètres possibles pour un DEVMODE. La valeur de ce paramètre doit être membre de l’énumération EDefaultDevmodeType , cast en tant qu’INT.
-
scope [in]
-
Valeur qui spécifie l’étendue de pPrintTicket. Cette valeur peut spécifier une page unique, un document entier ou tous les documents du travail d’impression. La valeur de ce paramètre doit être membre de l’énumération EPrintTicketScope , cast en tant que DWORD.
-
ppDevmode [out]
-
Adresse du DEVMODE nouvellement créé. Cette fonction appelle CoTaskMemAlloc pour allouer cette mémoire tampon. Lorsque la mémoire tampon n’est plus nécessaire, l’appelant doit la libérer en appelant CoTaskMemFree.
-
pcbDevModeLength [out]
-
Taille, en octets, du DEVMODE retourné dans ppDevmode.
-
errMsg [out, facultatif]
-
Pointeur vers une chaîne qui spécifie ce qui, le cas échéant, n’est pas valide pour le ticket d’impression dans pPrintTicket. S’il est valide, cette valeur est NULL. Si errMsg n’est pas NULL lorsque la fonction retourne, l’appelant doit libérer la chaîne avec SysFreeString.
Valeur retournée
Si la méthode réussit, elle retourne S_OK ; sinon, il retourne un code d’erreur HRESULT . Pour plus d’informations sur les codes d’erreur COM, consultez Gestion des erreurs.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| DLL |
|