ProductCatalog3.GetDependentCatalogs Method (PIA)

Article
11/12/2009

Use this method to return a recordset with a single field containing all of the virtual catalogs that are dependent on this catalog. This method cannot be called on a virtual catalog.

Definition

[Visual Basic .NET]

Imports Microsoft.CommerceServer.Interop.Catalog
Imports ADODB26Lib     ' for _Recordset
…
Public Function GetDependentCatalogs(Optional lStartingRecord As Object,
  Optional lRecordsToRetrieve As Object,
  Optional plTotalRecordsInQuery As Object) As _Recordset

[C#]

using Microsoft.CommerceServer.Interop.Catalog;
using ADODB26Lib;                              //For _Recordset
…
public _Recordset GetDependentCatalogs();objectlStartingRecord,
  objectlRecordsToRetrieve,
  objectplTotalRecordsInQuery,
);

Parameters

[Visual Basic .NET]

lStartingRecord
An Object that contains the starting record number. A value of one (1) indicates the first record. If the starting record number is not specified, then this method starts with record one (1).
lRecordsToRetrieve
An Object that contains the number of records to retrieve.
plTotalRecordsInQuery
An Object that, if supplied, contains on output the total number of records.

[C#]

lStartingRecord
An Object that contains the starting record number. A value of one (1) indicates the first record. If the starting record number is not specified, then this method starts with record one (1).
lRecordsToRetrieve
An Object that contains the number of records to retrieve.
plTotalRecordsInQuery
An Object that, if supplied, contains on output the total number of records.

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_CAT_INVALID_RS_POINTER	[C#] 0x889800B7 [Visual Basic .NET] &H889800B7	The recordset pointer that you specified is invalid
E_CAT_VC_NOT_A_SUPPLIER_CATALOG	[C#] 0x889800F9 [Visual Basic .NET] &H889800F9	Invalid catalog type. This API can only be called on a base catalog.

E_CAT_INVALID_RS_POINTER

[C#] 0x889800B7

[Visual Basic .NET] &H889800B7

The recordset pointer that you specified is invalid

E_CAT_VC_NOT_A_SUPPLIER_CATALOG

[C#] 0x889800F9

[Visual Basic .NET] &H889800F9

Invalid catalog type. This API can only be called on a base catalog.

Remarks

For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.

Requirements

Namespace: Microsoft.CommerceServer.Interop.Catalog

Platforms: Windows 2000, Windows Server 2003

Assembly: cataloglib (in cataloglib.dll)

Share via