Product.AddRelationshipToCategory
Use this method to add a relationship to a specified category from this product.
Definition
Sub AddRelationshipToCategory(strRelatedCategoryName As String,strRelationshipName As String,Optional strRelationshipDescription As Variant)
Parameters
strRelatedCategoryName
A String that contains the name of the category to which a relationship is to be added.
strRelationshipName
A String that contains a name for the relationship.
strRelationshipDescription
A Variant that optionally contains a description for the relationship.
Return Values
None.
Error Values
This method sets the Number property of the global Err object to S_OK (&H00000000) to indicate success and to either standard or custom COM error values to indicate failure. For more information about standard COM errors, see Standard COM Errors.
The following table shows the custom COM errors that this method can return.
Constant | Value | Description |
E_CAT_CATEGORY_DOESNT_EXIST | &H8898001C | The specified category did not exist. |
E_CAT_INVALID_RELATION | &H88980039 | The specified relationship was invalid. For example, a category or product cannot be related to itself. |
E_CAT_INVALID_RELATION_DESC | &H88980055 | The relationship description exceeded 256 characters. |
E_CAT_INVALID_RELATION_NAME | &H88980054 | The relationship name exceeded 128 characters. |
E_CAT_RELATIONSHIP_EXISTS | &H88980033 | The specified relationship already existed. |
Additional information may be available using the global Err object. In particular, the Description property may contain a text description of the error.
Remarks
The new relationship must have a name, which you specify in the strRelationshipName parameter. It may also optionally have a description, which you can specify in the strRelationshipDescription parameter.
More than one relationship may be created between the same product and category, however in this case each relationship created must be given a unique name.
For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.
Example
'vDesc is a Variant of subtype String containing the description.
myProduct.AddRelationshipToCategory "Apparel", "Accessory", vDesc
See Also
Product.AddRelationshipToProduct