Edit

Share via

IPrinterPropertyBag::SetString method (printerextension.h)

  • Article

Writes a string property.

Syntax

HRESULT SetString(
  [in] BSTR bstrName,
  [in] BSTR bstrValue
);

Parameters

[in] bstrName

The property to set.

[in] bstrValue

The property value to set.

Return value

This method returns an HRESULT value.

Remarks

In Windows 8.1 a new flag, PRINTER_ACCESS_MANAGE_LIMITED, has been introduced to grant print queue permissions that are more limited than PRINTER_ACCESS_ADMINISTER, but more powerful than PRINTER_ACCESS_USE.

The permissions are a subset of those associated with PRINTER_ACCESS_ADMINISTER. This means that if the currently logged-on user has PRINTER_ACCESS_ADMINISTER permission, the user can gain PRINTER_ACCESS_MANAGE_LIMITED access to the queue.

A call to set a property on a queue property bag will fail with ERROR_ACCESS_DENIED, if the user does not have the appropriate permission. This behavior was true before PRINTER_ACCESS_MANAGE_LIMITED was introduced, and it's still the current behavior.

Requirements

Requirement Value
Target Platform Desktop
Header printerextension.h (include Printerextension.h)

See also

IPrinterPropertyBag