GetPrintCapabilitiesThunk2 fonction)
[Cette fonction n’est pas prise en charge et peut être désactivée ou supprimée dans les versions ultérieures de Windows. PTGetPrintCapabilities fournit des fonctionnalités équivalentes et doit être utilisé à la place.]
Récupère les fonctionnalités de l’imprimante mises en forme en conformité avec le schéma d’impressionXML.
Syntaxe
HRESULT GetPrintCapabilitiesThunk2(
_In_ HPTPROVIDER hProvider,
_In_ BYTE *pPrintTicket,
_In_ INT cbPrintTicket,
_Out_ BYTE **ppbPrintCapabilities,
_Out_ INT *pcbPrintCapabilitiesLength,
_Out_opt_ BSTR *pbstrErrorMessage
);
Paramètres
-
hProvider [ dans]
-
Handle d’un fournisseur de tickets d’impression ouvert. Ce descripteur est retourné par la fonction BindPTProviderThunk .
-
pPrintTicket [ dans]
-
Mémoire tampon qui contient les données du ticket d’impression, exprimées en XML, comme décrit dans le schéma d’impression.
-
cbPrintTicket [ dans]
-
Taille, en octets, de la mémoire tampon référencée par pPrintTicket.
-
ppbPrintCapabilities [ à]
-
L’adresse de la mémoire tampon allouée par cette fonction et contient les informations de fonctionnalités d’impression valides, encodées au format XML. 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.
-
pcbPrintCapabilitiesLength [ à]
-
Taille, en octets, de la mémoire tampon référencée par ppbPrintCapabilities.
-
pbstrErrorMessage [ out, facultatif]
-
Pointeur vers une chaîne qui spécifie ce qui, le cas échéant, n’est pas valide sur pPrintTicket. S’il est valide, cette valeur est null. Si pbstrErrorMessage n’a pas la valeur null lorsque la fonction retourne, l’appelant doit libérer la chaîne avec SysFreeString.
Valeur retournée
Si la méthode est réussie, elle retourne S _ OK; sinon, elle retourne un code d’erreur HRESULT . Pour plus d’informations sur les codes d’erreur COM, consultez gestion des erreurs.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau XP uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2003 [ applications de bureau uniquement] |
| DLL |
|