CDC::Escape

Artículo
02/19/2013

Esta función miembro es prácticamente obsoleto para la programación de Win32.

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

Parámetros

nEscape
Especifica la función de escape que se va a realizar.

Para obtener una lista completa de las funciones de escape, vea escape en Windows SDK.
nCount
Especifica el número de bytes de datos indicada por lpszInData.
lpszInData
Señala la estructura de datos de entrada necesaria para este escape.
lpOutData
Señala la estructura que es recibir la salida de este escape.El parámetro de lpOutData es NULL si no se devuelve ningún dato.
nInputSize
Especifica el número de bytes de datos señalados por el parámetro de lpszInputData .
lpszInputData
Puntos en la estructura de la entrada necesaria para el escape especificado.
nOutputSize
Especifica el número de bytes de datos señalados por el parámetro de lpszOutputData .
lpszOutputData
Señala la estructura que recibe la salida de este escape.Este parámetro debe ser NULL si no se devuelve ningún dato.

Valor devuelto

Se devuelve un valor positivo si la función es correcta, salvo el escape de QUERYESCSUPPORT , que sólo comprueba la existencia de implementación.Se devuelve cero si el escape no se implementa.Se devuelve un valor negativo si se ha producido un error.Los siguientes son valores de error comunes:

Error deSP_ERROR General.
SP_OUTOFDISK No hay espacio en disco está disponible actualmente para poner en cola, y no más de espacio estará disponible.
SP_OUTOFMEMORY No suficiente memoria disponible para poner en cola.
El usuario deSP_USERABORT terminó el trabajo a través del administrador de impresión.

Comentarios

De pérdidas de impresora de original, sólo QUERYESCSUPPORT se admite para aplicaciones Win32.El resto de pérdidas de impresora están obsoletos y solo se admiten para la compatibilidad con las aplicaciones de 16 bits.

Para Win32 que programa, CDC ahora proporciona seis funciones miembro que reemplazan las secuencias correspondientes de la impresora:

Además, los índices de Win32 de la de CDC::GetDeviceCaps que reemplazan la otra impresora se pierden.Vea GetDeviceCaps en Windows SDK para obtener más información.

Esta función miembro permite a las aplicaciones para tener acceso a las funciones de un dispositivo determinado que no son directamente GDI directo disponibles.

Utilice la primera versión si sus aplicaciones de la aplicación predefinidas escapan valores.Utilice la segunda versión si la aplicación define valores privados de escape.Vea ExtEscape en Windows SDK para obtener más información sobre la segunda versión.