ProductCatalog3.RemoveLanguage Method (PIA)

Article
11/12/2009

Use this method to remove a language from this catalog.

Definition

[Visual Basic .NET]

Imports Microsoft.CommerceServer.Interop.Catalog
…
Public Sub RemoveLanguage(strLanguage As String)

[C#]

using Microsoft.CommerceServer.Interop.Catalog;
…
public void RemoveLanguage(BSTRstrLanguage);

Parameters

[Visual Basic .NET]

strLanguage
A String that contains the ISO 639+1 code that specifies the language to remove.

[C#]

strLanguage
A string that contains the ISO 639+1 code that specifies the language to remove.

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_LANGUAGE	[C#] 0x8898009E [Visual Basic .NET] &H8898009E	The value you specified for the language parameter is either empty or exceeds the maximum length of 10 characters.
E_CAT_LANGUAGE_NOT_ASSOCIATED	[C#] 0x889800A4 [Visual Basic .NET] &H889800A4	The language that you specified is not associated with this catalog.
E_CAT_CATALOG_DOESNT_EXIST	[C#] 0x88980002 [Visual Basic .NET] &H88980002	The catalog name you specified does not exist.
E_CAT_CANNOT_REMOVE_DEFAULT_LANG	[C#] 0x889800AA [Visual Basic .NET] &H889800AA	The language that you specified is being used as the default language for this catalog. It cannot be removed.
E_CAT_CANNOT_REMOVE_REPORTING_LANG	[C#] 0x889800AB [Visual Basic .NET] &H889800AB	The language that you specified is being used as the reporting language for this catalog. It cannot be removed.

Remarks

This method removes the specified language from list of languages supported by the catalog. The language will not be removed if it is the default language or reporting language of the catalog; in this case, an error message will be returned.

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