IPrinterPropertyBag::SetBool method (printerextension.h)

Writes a specified boolean property value.

Syntax

HRESULT SetBool(
  [in] BSTR bstrName,
  [in] BOOL bValue
);

Parameters

[in] bstrName

The property to set.

[in] bValue

The 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