Product.AddRelationshipToProduct
.gif "Ee823378.c++_on(en-US,CS.10).gif")
.gif "Ee823378.vb_off(en-US,CS.10).gif")
Use this method to add a relationship to a specified product from this product.
Definition
Sub AddRelationshipToProduct(varRelatedProductID As Variant,strRelationshipName As String,Optional strRelationshipDescription As Variant)
Parameters
varRelatedProductID
A Variant that contains the ID of the related product.
strRelationshipName
A String that contains the name of 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_INVALID_RELATION | &H88980039 | The specified relationship was invalid. For example, a 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_PRODUCT_DOESNT_EXIST | &H8898001E | The specified product ID did not exist. |
| 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 two products, 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
'vProdID is a Variant containing the product ID
'vDesc is a Variant of subtype String containing a description
'of the relationship
myProduct.AddRelationshipToProduct vProdID, "Accessory", vDesc
See Also
Product.AddRelationshipToCategory