CDC::Escape

Статья
02/20/2013

Это функция-член практических являются устаревшими для программирования Win32.

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

Параметры

nEscape
Определяет функцию escape, которую необходимо выполнить.

Полный список функций см. в разделе Escape escape-последовательности в Windows SDK.
nCount
Указывает число байтов данных, указанных в lpszInData.
lpszInData
Указатель на структуру данных для ввода для экранирования.
lpOutData
Указатель на структуру, чтобы получить данные из этого escape.Параметр lpOutDataNULL если никакие данные не возвращаются.
nInputSize
Указывает число байтов данных, указанных в параметрах lpszInputData.
lpszInputData
Указатель на структуру ввода для заданного для экранирования.
nOutputSize
Указывает число байтов данных, указанных в параметрах lpszOutputData.
lpszOutputData
Указатель на структуру, принимающий выходные данные из этого escape.Этот параметр должен быть NULL если никакие данные не возвращаются.

Возвращаемое значение

Положительное значение возвращается, если функция завершается успешно, за исключением escape QUERYESCSUPPORT, которое проверяет только для реализации.Ноль, если избежать не реализовано.Отрицательное значение возвращается, если произошла ошибка.Следующие распространенные значения ошибки:

Ошибка общих SP_ERROR.
SP_OUTOFDISK Недостаточно места на диске в настоящее время доступны для наматывать, и больше места не станут доступными.
SP_OUTOFMEMORY Недостаточно памяти доступно для наматывать.
Пользователь SP_USERABORT выполнения задания через диспетчер печати.

Заметки

Избежаний принтера оригинала, QUERYESCSUPPORT поддерживается только для приложений Win32.Все остальные escape-последовательности принтера устарел и поддерживается только для обеспечения совместимости с 16-разрядными приложениями.

Для программирования Win32, CDC 6 теперь предоставляет функции-члены, которые заменяют их соответствующие escape принтера.

Кроме того, индексы CDC::GetDeviceCaps обозреватель Win32, которые заменяют другой принтер избегают.См. раздел GetDeviceCaps в Windows SDK дополнительные сведения.

Эта функция-член позволяет приложениям получать доступ средства, заданного устройства, не напрямую, доступные с помощью GDI.

Используйте первую версию если предопределенные использования приложения избегают значения.Используйте вторую версию если приложение указывает закрытые значения escape.См. раздел ExtEscape в Windows SDK дополнительные сведения о второй версии.