Метод IPrintCoreHelper::EnumConstrainedOptions (prcomoem.h)
Метод IPrintCoreHelper::EnumConstrainedOptions предоставляет список всех параметров, ограниченных в определенной функции на основе текущих параметров.
Синтаксис
HRESULT EnumConstrainedOptions(
[in, optional] IN const DEVMODE *pDevmode,
[in] IN DWORD cbSize,
[in] IN PCSTR pszFeatureKeyword,
[out] OUT PCSTR * [] pConstrainedOptionList,
[out] OUT DWORD *pdwNumOptions
);
Параметры
[in, optional] pDevmode
Указатель на структуру DEVMODEW. Если указан этот указатель, IPrintCoreHelper::EnumConstrainedOptions следует использовать структуру DEVMODEW, на которую указывает pDevmode вместо текущей структуры DEVMODEW. Если этот метод вызывается из поставщика подключаемых модулей или из IPrintOemPS::D evMode или IPrintOemUni::D evMode или от поставщика билетов печати, этот параметр требуется. В большинстве других ситуаций параметр должен быть null. Если основной драйвер задает pDevmode значение NULL, он изменяет внутреннее состояние, а не структуру DEVMODEW. Это необходимо во время таких операций, как полная замена пользовательского интерфейса, где структура DEVMODEW, возвращаемая DDI, например DrvDocumentPropertySheets, обслуживается модулем пользовательского интерфейса основного драйвера.
[in] cbSize
Размер структуры DEVMODEW в байтах, на которую указывает параметр pDevmode.
[in] pszFeatureKeyword
Строка символов ANSI, содержащих имя функции.
[out] pConstrainedOptionList
Указатель на массив строк символов ANSI. Когда IPrintCoreHelper::EnumConstrainedOptions возвращается, эти строки будут содержать имена всех параметров, ограниченных в указанной функции. Вызывающий объект не несет ответственности за освобождение массива или отдельных строк в массиве.
[out] pdwNumOptions
Указатель на переменную, которая получает количество ограниченных параметров в массиве, на который указывает параметр pConstrainedOptionList.
Возвращаемое значение
IPrintCoreHelper::EnumConstrainedOptions должен возвращать одно из следующих значений.
| Возвращаемый код | Описание |
|---|---|
| S_OK | Для указанной функции были заданы ограниченные параметры. |
| E_FAIL | Вызывающий объект предоставил информацию, которая привела к недопустимому запросу, например запросу на функцию, которая не существует. |
| E_INVALIDARG | Один или несколько аргументов были недопустимыми. Это значение может означать, что функция не поддерживается. |
| E_OUTOFMEMORY | Недостаточно памяти для создания массива параметров или основного драйвера не удалось обслуживать запрос из-за нехватки памяти. |
| E_UNEXPECTED или другие сбои, не перечисленные здесь, | Произошло непредвиденное условие. Основной драйвер, вероятно, находится в недопустимом состоянии. Вызывающий объект должен выйти из кода сбоя. |
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | prcomoem.h (include Prcomoem.h) |