IPrintSchemaTicket::GetFeature method (printerextension.h)
Gets a named feature from the PrintTicket, by name and full namespace URI.
Syntax
HRESULT GetFeature(
[in] BSTR bstrName,
[in] BSTR bstrNamespaceUri,
[out, retval] IPrintSchemaFeature **ppFeature
);
Parameters
[in] bstrName
The base name of the name attribute value of the feature element. For example, for the Print Schema feature <psf:Feature name="psk:JobOutputBin">, the base name of the feature is "JobOutputBin".
[in] bstrNamespaceUri
The namespace URI of the name attribute value of the feature element. For example, the namespace URI of the public Print Schema feature "JobOutputBin" is "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords". If the feature is not defined in the public Print Schema, then this should be the URI of the private namespace defining the feature.
[out, retval] ppFeature
The returned feature.
Return value
This method returns an HRESULT value.
Remarks
When the requested feature, option or property is not found, this method returns S_FALSE and sets a NULL pointer on the output object of the feature, option or property.
So if the IPrintSchemaTicket object does not contain the specified feature, option or property, the app must obtain an IPrintSchemaCapabilities object and query it via IPrintSchemaCapabilities::GetFeatureByKeyName or via IPrintSchemaCapabilities::GetFeature.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8 |
Target Platform | Desktop |
Header | printerextension.h |
See also
IPrintSchemaCapabilities::GetFeature