IProduct3::get_UseCategoryPricing, put_UseCategoryPricing Property [C++]

Article
11/12/2009

The UseCategoryPricing property is a read/write Boolean that determines whether the price of the product will be determined from the PrimaryParent property of the product.

Definition

[C++]

Get method:

HRESULT IProduct3::get_UseCategoryPricing(VARIANT_BOOL*UseCategoryPricing);

Put method:

HRESULT IProduct3::put_UseCategoryPricing(VARIANT_BOOLUseCategoryPricing);

[Visual Basic]

Property UseCategoryPricing As Boolean

Parameters

UseCategoryPricing[C++]
[in] When putting the property, a VARIANT_BOOL that specifies whether to use category pricing.
[out, retval] When getting the property, a pointer to a VARIANT_BOOL used to return the value of the UseCategoryPricing property. See the Remarks section for the effects of this property.

[Visual Basic] None.

[C++]

Return Values

These methods return an HRESULT indicating whether they completed successfully. See the Error Values section for more details.

Error Values

[C++] These methods return S_OK (0x00000000) to indicate success and standard COM HRESULT error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object, which can be accessed using the API function GetErrorInfo. In particular, the GetDescription method of the IErrorInfo interface may return a text description of the error.

[Visual Basic] This property sets the Number property of the global Err object to S_OK (&H00000000) to indicate success and to standard COM error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object. In particular, the Description property may contain a text description of the error.

The following table describes the custom COM errors this method can return.

Constant	Value	Description
E_CAT_VC_NOT_A_SUPPLIER_CATALOG	[C++] 0x889800F9 [Visual Basic] &H889800F9	Invalid catalog type. This API can only be called on a base catalog.
E_CAT_INVALID_PRIMARY_PARENT	[C++] 0x889800DA [Visual Basic] &H889800DA	To use category pricing for this product, you should first set a primary parent category.
E_CAT_PRODUCT_DOESNT_EXIST	[C++] 0x8898001E [Visual Basic] &H8898001E	The product you specified doesn't exist.
E_CAT_CATEGORY_DOESNT_EXIST	[C++] 0x8898001C [Visual Basic] &H8898001C	The category you specified doesn't exist.
E_CAT_PRICING_CAT_PRICELESS	[C++] 0x8898002F [Visual Basic] &H8898002F	The category you specified has no list price. The list price of the category has to be set before using this for pricing.

Remarks

A value of True indicates that the price of the product will be determined from the PrimaryParent category of the product. A value of False indicates that the price of the product will not be determined from the PrimaryParent category.

Ee824518.note(en-US,CS.20).gif Note

If this product is inherited by a virtual catalog, the PrimaryParent property cannot be set from the virtual catalog.

[C++] If the property is set to True the PricingCategory property will be set to and become synonymous with the PrimaryParent property.

[Visual Basic] If the property is set to True the PricingCategory property will be set to and become synonymous with the PrimaryParent property.