_BusinessDataAdmin2::ExportCatalogs Method [C++]

Use this method to export the profile catalog (profile schema) in the business data store to an XML file.

Definition

[C++]

HRESULT _BusinessDataAdmin2::ExportCatalogs(BSTR*sFileName,
  VARIANT_BOOL*bRemoveCredentials);

[Visual Basic]

Sub ExportCatalogs(sFileName As String,
  Optional bRemoveCredentials As Boolean)

Parameters

• sFileName[C++]
  [in, out] A pointer to A BSTR that specifies the file that will contain the exported profile catalog. This is a local file path — it cannot be a URL.
• sFileName[Visual Basic]
  A String that specifies the file that will contain the exported profile catalog. This is a local file path — it cannot be a URL.
• bRemoveCredentials[C++]
  [in, optional] A pointer to a VARIANT_BOOL that specifies whether to remove the credentials from the connection strings in the profile catalog. A value of True indicates remove the credentials. A value of False indicates do not remove the credentials. The default value True.
• bRemoveCredentials[Visual Basic]
  A Boolean that specifies whether to remove the credentials from the connection strings in the profile catalog. A value of True indicates remove the credentials. A value of False indicates do not remove the credentials. The default value is True.

Return Values

[C++] This method returns an HRESULT indicating whether it completed successfully. See the Error Values section for more details.

[Visual Basic] None.

Error Values

[C++] This method returns S_OK (0x00000000) to indicate success and either standard or custom COM HRESULT error values to indicate failure. For more information about standard COM errors, see Standard COM Errors.

[Visual Basic] 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.

Remarks

You must call the Connect method before calling this method.

The exported XML document will conform to the schema specified in file MSCSProfileSchema.xml, and will contain both site terms and profile definitions.

If the bRemoveCredentials parameter is True, then the credentials (user name and password) will be removed from all connection strings. These credentials will have to be replaced before the catalog can be imported. If the catalog is imported through Commerce Server Manager, the user must enter a user name and password for each data source partition in the catalog. See Exporting Profile Schema for more information.

If the bRemoveCredentials parameter is False, then the credentials will be exported in plain text with the rest of the catalog.

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

[Visual Basic]

Example

The following example exports the profile catalog to a file:

myBusinessDataAdmin2.ExportCatalogs("C:\myfolder\myProfileCatalog.xml",_
   bRemoveCredentials)

See Also

[C++]BusinessDataAdmin2 Object

[Visual Basic]BusinessDataAdmin2 Object

Copyright © 2005 Microsoft Corporation.
All rights reserved.