Метод IPrintDialogServices::GetCurrentPortName (commdlg.h)
Извлекает имя текущего порта для использования с PrintDlgEx.
Синтаксис
HRESULT GetCurrentPortName(
LPWSTR pPortName,
UINT *pcchSize
);
Параметры
pPortName
Тип: LPTSTR
Имя текущего порта.
pcchSize
Тип: UINT*
На входных данных переменная указывает размер буфера в символах, на который указывает параметр lpPortName . В выходных данных переменная содержит количество байтов (ANSI) или символов (Юникод), включая завершающий пустой символ, записанный в буфер.
Если для входных данных размер равен нулю, функция возвращает требуемый размер буфера (в байтах или символах) в pcchSize и не использует буфер lpPortName .
Возвращаемое значение
Тип: HRESULT
Если метод выполнен успешно, возвращаемое значение будет S_OK. Если текущий порт отсутствует, возвращаемое значение S_OK, значение, возвращаемое в pcchSize , равно нулю, а буфер lpPortName не изменяется.
При возникновении ошибки возвращаемое значение представляет собой код ошибки COM. Дополнительные сведения см. в разделе Обработка ошибок.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | commdlg.h (включая Windows.h) |
| DLL | Comdlg32.dll |
См. также раздел
Общая библиотека диалоговых окон
Основные понятия
Справочные материалы