IPrintSchemaCapabilities2::GetParameterDefinition method (printerextension.h)

The GetParameterDefinition method retrieves the IPrintSchemaParameterDefinition object, and it represents the psf:ParameterDef element in the PrintCapabilites XML.

The keyword name and keyword namespace URI specify the IPrintSchemaParameterDefinition object to be retrieved.


HRESULT GetParameterDefinition(
  [in]          BSTR                            bstrName,
  [in]          BSTR                            bstrNamespaceUri,
  [out, retval] IPrintSchemaParameterDefinition **ppParameterDefinition


[in] bstrName

The keyword name

[in] bstrNamespaceUri

The keyword namespace URI

[out, retval] ppParameterDefinition

The IPrintSchemaParameterDefinition object

Return value

The GetParameterDefinition method returns an HRESULT value. If the property call was not successful, it returns the appropriate HRESULT error code.


To be consistent with IPrintSchemaCapabilities::GetFeature, the GetParameterDefinition method works for any psf:ParameterDef element that is defined in the public keyword namespaces. The GetParameterDefinition method also works for any IHV-defined private keyword namespace that uses either the StringParamType or the IntegerParamType data type.

When you use the psf:ParameterDef element with the QNameParamType or the DecimalParamType data type, GetParameterDefinition will return HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED).

For more information about the data types that you can use with the psf:ParameterDef element, see section of the Print Schema Specification.


Minimum supported client Windows 8.1
Minimum supported server Windows Server 2012 R2
Target Platform Desktop
Header printerextension.h

See also



Print Schema Specification