CDC::Escape

This member function is practically obsolete for Win32 programming.

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

Parameters

  • nEscape
    Specifies the escape function to be performed.

    For a complete list of escape functions, see Escape in the Windows SDK.

  • nCount
    Specifies the number of bytes of data pointed to by lpszInData.

  • lpszInData
    Points to the input data structure required for this escape.

  • lpOutData
    Points to the structure that is to receive output from this escape. The lpOutData parameter is NULL if no data is returned.

  • nInputSize
    Specifies the number of bytes of data pointed to by the lpszInputData parameter.

  • lpszInputData
    Points to the input structure required for the specified escape.

  • nOutputSize
    Specifies the number of bytes of data pointed to by the lpszOutputData parameter.

  • lpszOutputData
    Points to the structure that receives output from this escape. This parameter should be NULL if no data is returned.

Return Value

A positive value is returned if the function is successful, except for the QUERYESCSUPPORT escape, which only checks for implementation. Zero is returned if the escape is not implemented. A negative value is returned if an error occurred. The following are common error values:

  • SP_ERROR   General error.

  • SP_OUTOFDISK   Not enough disk space is currently available for spooling, and no more space will become available.

  • SP_OUTOFMEMORY   Not enough memory is available for spooling.

  • SP_USERABORT   User ended the job through the Print Manager.

Remarks

Of the original printer escapes, only QUERYESCSUPPORT is supported for Win32 applications. All other printer escapes are obsolete and are supported only for compatibility with 16-bit applications.

For Win32 programming, CDC now provides six member functions that supersede their corresponding printer escapes:

In addition, CDC::GetDeviceCaps supports Win32 indexes that supersede other printer escapes. See GetDeviceCaps in the Windows SDK for more information.

This member function allows applications to access facilities of a particular device that are not directly available through GDI.

Use the first version if your application uses predefined escape values. Use the second version if your application defines private escape values. See ExtEscape in the Windows SDK for more information about the second version.

Requirements

Header: afxwin.h

See Also

Reference

CDC Class

Hierarchy Chart

CDC::ResetDC

EnumObjects

Other Resources

CDC Members