IPrintCoreHelperUni::EnumConstrainedOptions method (prcomoem.h)
The IPrintCoreHelperUni::EnumConstrainedOptions method provides a list of all of the options that are constrained in a particular feature, based on current settings.
Syntax
HRESULT EnumConstrainedOptions(
[in, optional] IN const DEVMODE *pDevmode,
[in] IN DWORD cbSize,
[in] IN PCSTR pszFeatureKeyword,
[out] OUT PCSTR * [] pConstrainedOptionList,
[out] OUT DWORD *pdwNumOptions
);
Parameters
[in, optional] pDevmode
A pointer to a DEVMODEW structure. If this pointer is provided, IPrintCoreHelperUni::EnumConstrainedOptions should use the DEVMODEW structure that is pointed to by pDevmode instead of the default or current DEVMODEW structure. If this method is called from the plug-in provider or from IPrintOemUni::DevMode, this parameter is required. In most other situations, the parameter should be NULL. When the core driver sets pDevmode to NULL, it modifies its internal state rather than that of the passed-in DEVMODEW structure. This is required during operations such as full UI replacement, where the DEVMODEW structure returned by a DDI, such as DrvDocumentPropertySheets, is being serviced by the core driver's UI module.
[in] cbSize
The size, in bytes, of the DEVMODEW structure that is pointed to by the pDevmode parameter.
[in] pszFeatureKeyword
A string of ANSI characters that contains the feature name.
[out] pConstrainedOptionList
A pointer to an array of ANSI character strings. When IPrintCoreHelperUni::EnumConstrainedOptions returns, these strings will contain the names of all of the options that are constrained within the specified feature. The caller is not responsible for freeing the array or the individual strings in the array.
[out] pdwNumOptions
A pointer to a variable that receives the number of constrained options in the array that is pointed to by the pConstrainedOptionList parameter.
Return value
IPrintCoreHelperUni::EnumConstrainedOptions should return one of the following values.
| Return code | Description |
|---|---|
| S_OK | The constrained options were set for the specified feature. |
| E_FAIL | The caller provided information that resulted in an invalid request, such as a request for a feature that does not exist. |
| E_INVALIDARG | One or more of the arguments were invalid. This value might mean that the feature is not supported. |
| E_OUTOFMEMORY | There was not enough memory to create the options array or the core driver could not service the request due to lack of memory. |
| E_UNEXPECTED, or other failures not listed here | An unexpected condition occurred. The core driver is probably in an invalid state. The caller should exit with a failure code. |
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | prcomoem.h (include Prcomoem.h) |