Share via

ProductCatalog3.SetCatalogAttributes Method (PIA)

Use this method to set the attributes of a catalog.

Definition

[Visual Basic .NET]

Imports Microsoft.CommerceServer.Interop.Catalog
Import ADODB26Lib     ‘ for _Recordset
…
Public Sub SetCatalogAttributes(pRSCatalogAttributes As _Recordset,
 Optional fForceUpdate As Object)

[C#]

using Microsoft.CommerceServer.Interop.Catalog;
using ADODB26Lib;                              //For _Recordset
…
public void SetCatalogAttributes( _RecordsetpRSCatalogAttributes,
 object fForceUpdate);

Parameters

[Visual Basic .NET]

  • pRSCatalogAttributes
    A _Recordset interface to a Recordset object containing the new attributes.
  • fForceUpdate
    An Object that causes a forced update of the catalog attributes.

[C#]

  • pRSCatalogAttributes
    A _Recordset interface to a Recordset containing the new attributes.
  • fForceUpdate
    An object that causes a forced update of the catalog attributes. Set to Type.Missing for default behavior.

Exceptions

This method may throw one of many mapped exceptions or an exception of type COMException. See Standard COM Errors for additional details.

The following table shows the custom COM errors that COMException may wrap as exceptions for this method.

Constant Value Description
E_INVALIDARG

[C#] 0x80070057

[Visual Basic .NET] &H80070057

 One or more arguments are invalid.
E_CAT_BLANK_LANGUAGE

[C#] 0x889800A5

[Visual Basic .NET] &H889800A5

 The default language associated with this catalog cannot be blank.
E_CAT_CATALOG_DOESNT_EXIST

[C#] 0x88980002

[Visual Basic .NET] &Hx88980002

 The catalog name you specified does not exist.
E_CAT_INVALID_DEFAULT_LANGUAGE

[C#] 0x889800B3

[Visual Basic .NET] &Hx889800B3

 The default language that you specified does not exist as one of the valid catalog languages.
E_CAT_CATALOG_CHANGED

[C#] 0x88980012

[Visual Basic .NET] &Hx88980012

 The catalog properties have been changed since it was last read.

Remarks

Use the GetCatalogAttributes method to get a Recordset of the current attributes. After the Recordset has been modified, use it as the pRSCatalogAttributes parameter to the SetCatalogAttributes method to write the changes back to the catalog. The timestamps in the Recordset will be compared to the timestamps of the attributes being updated for error detection.

The catalog Name, ProductID, CatalogID, and VariantID attributes cannot be changed with this method.

[Visual Basic .NET]

Example

myProductCatalog.SetCatalogAttributes(rsCatalogAttribs, True)

Requirements

Namespace: Microsoft.CommerceServer.Interop.Catalog

Platforms: Windows 2000, Windows Server 2003

Assembly: cataloglib (in cataloglib.dll)

See Also

ProductCatalog3 Class

ProductCatalog3.GetCatalogAttributes

Copyright © 2005 Microsoft Corporation.
All rights reserved.

  • Last updated on