CDC::Escape

Article
03/04/2013

Cette fonction membre est pratiquement obsolète pour la programmation Win32.

virtual int Escape(
   int nEscape,
   int nCount,
   LPCSTR lpszInData,
   LPVOID lpOutData 
);
int Escape(
   int nEscape,
   int nInputSize,
   LPCSTR lpszInputData,
   int nOutputSize,
   LPSTR lpszOutputData 
);

Paramètres

nEscape
Spécifie la fonction d'échappement à exécuter.

Pour une liste complète des fonctions d'échappement, consultez l' Échappement dans Kit de développement logiciel Windows.
nCount
Spécifie le nombre d'octets de données pointées pointe vers lpszInData.
lpszInData
Pointe vers la structure de données d'entrée requise pour cette échappement.
lpOutData
Pointe vers une structure qui consiste à accepter la sortie de cette échappement.Le paramètre d' lpOutData est NULL si aucune donnée n'est retournée.
nInputSize
Spécifie le nombre d'octets de données pointées pointe vers le paramètre d' lpszInputData .
lpszInputData
Pointe vers la structure d'entrée requise pour l'échappement spécifiée.
nOutputSize
Spécifie le nombre d'octets de données pointées pointe vers le paramètre d' lpszOutputData .
lpszOutputData
Pointe vers une structure qui accepte la sortie de cette échappement.Ce paramètre doit être NULL si aucune donnée n'est retournée.

Valeur de retour

Une valeur positive est retournée si la fonction est réussie, à l'exception de l'échappement de QUERYESCSUPPORT , qui vérifie uniquement l'implémentation.Zéro est retournée si l'échappement n'est pas implémentée.Une valeur négative est retournée si une erreur se produit.Voici les valeurs d'erreur courante :

Erreur de général deSP_ERROR .
SP_OUTOFDISK pas suffisamment d'espace disque est disponible pour la mise en attente, puis plus d'espace ne devient disponible.
SP_OUTOFMEMORY pas assez de mémoire est disponible pour la mise en attente.
L'utilisateur deSP_USERABORT a effectué le travail via Gestionnaire d'impression.

Notes

Échappe d'imprimante d'origine, uniquement QUERYESCSUPPORT en charge pour les applications Win32.Toutes les autres échappements d'imprimante sont obsolètes et sont prises en charge uniquement pour la compatibilité avec les applications 16 bits.

Pour la programmation Win32, CDC fournit maintenant six fonctions membres qui remplacent leurs échappements correspondantes d'imprimante :

En outre, les index Win32 charge par CDC::GetDeviceCaps qui remplacent l'autre imprimante si remplace.Consultez GetDeviceCaps dans Kit de développement logiciel Windows pour plus d'informations.

Cette fonction membre permet aux applications d'accéder aux fonctionnalités d'un appareil particulier qui ne sont pas directement via GDI disponible.

Utilisez la première version si vos valeurs d'échappement prédéfini d'application utilise.Utilisez la deuxième version si votre application définit des valeurs privées d'échappement.Consultez l' ExtEscape dans Kit de développement logiciel Windows pour plus d'informations sur la deuxième version.