_BusinessDataAdmin2::ImportCatalogs [C++]

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

Definition

[C++]

HRESULT _BusinessDataAdmin2::ImportCatalogs(BSTR*sXMLDocument);

[Visual Basic]

Sub ImportCatalogs(sXMLDocument As String)

Parameters

• sXMLDocument[C++]
  [in] A pointer to a BSTR that contains the XML document containing the profile catalog to be imported.
• sXMLDocument[Visual Basic]
  A String that contains the XML document containing the profile catalog to be imported.

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 XML data in the parameter sXMLDocument must contain a single profile catalog, and it must conform to the schema in the file MSCSProfileSchema.xml.

If the catalog you want to import was exported without credentials you will need to add credentials for each data source in the catalog before it can be imported.

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 imports a catalog from the file ProfileCatalog.xml:

sConnstr = "Provider=SQLOLEDB;Persist Security Info=False;User ID=user;Password=xxxx;Initial Catalog=Test_commerce;Data Source=w2k;" 

Set oBizDataAdmin = CreateObject("Commerce.BusinessDataAdmin2") 

oBizDataAdmin.Connect(sConnstr) 

oBizDataAdmin.ExportCatalogs "c:\Profile.xml",False 

Dim xmlDoc 

Set xmlDoc = CreateObject("MSXML2.DOMDocument.3.0") 

xmlDoc.load "c:\Profile.xml" 

oBizDataAdmin.ImportCatalogs xmlDoc.xml 

Note

For the last line of this code sample, the following will not work: oBizDataAdmin.ImportCAtalogs "c:\Profile.xml"

See Also

[C++]BusinessDataAdmin2 Object

[Visual Basic]BusinessDataAdmin2 Object

Copyright © 2005 Microsoft Corporation.
All rights reserved.