Приложение, используя функцию PrintDlgEx может вызвать метод IPrintDialogServices::GetCurrentPortName, чтобы извлечь имя текущего порта.
Синтаксис
HRESULT GetCurrentPortName( LPTSTR lpPortName, UINT* pcchSize ); |
Параметры
lpPortName
Указатель на буфер, который получает имя текущего порта с символом конца строки ('\0').
pcchSize
Указатель на переменную типа UINT. При вводе данных, переменная устанавливает размер буфера, в TCHARs (символах), на который указывает параметр lpPortName. При выводе данных, переменная содержит число байтов (ANSI) или символов (Unicode), включая символ завершения строки ('0'), записанных в буфер.
Если при вводе данных размер равняется нулю, возвращаемое значение функцией - необходимый размер буфера (в байтах или символах) в pcchSize, а буфер lpPortName не используется.
Возвращаемое значение
Если метод успешен, возвращаемое значение - S_OK. Если нет никакого текущего порта, возвращаемое значение - S_OK, значение, возвращенное в pcchSize, равняется нулю, а буфер lpPortName не изменяется.
Если происходит ошибка, возвращаемое значение - код ошибки Объектной модели компонентов (COM). Для получения дополнительной информации, см. статью Обработка ошибок.
Смотри также
Обзор Библиотека стандартных диалоговых окон, Интерфейсные методы, используемые библиотекой стандартных диалоговых окон, PrintDlgEx
|
Размещение и совместимость IPrintDialogServices::GetCurrentPortName |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Нет |
|
Windows Me |
Нет |
|
Windows 98 |
Нет |
|
Windows 95 |
Нет |
|
Используемая библиотека |
- |
|
Заголовочный файл |
|
|
- объявлено в |
Commdlg.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |