ProfileService Object [C++]

Use this object to create, delete, and retrieve ProfileObject objects.

ProgID:   Commerce.ProfileService (Externally creatable)
COM Class Name:   ProfileService
Type Library Name:   Microsoft Commerce 2002 Profile Service Type Library
DLL Name:   mscsups.dll
Threading Model:   Both

[C++]

COM Interface Name:   IProfileService2
Interface ID Constant:   IID_IProfileService2
Header File:   mscsups.h, mspu_guids.h

[C++]

In C++, use the ProfileService2 interface to access the properties and methods of the ProfileService object.

Because this object is primarily intended for use within ASP script, access from C++ will not be common.

Methods

[C++]

Method Description
BindAs Sets the user credentials for accessing the underlying Profiles store.
CreateProfile Creates the specified ProfileObject object.
CreateProfileXML Creates a ProfileObject object from XML data.
DeleteProfile Deletes a ProfileObject object specified by a primary key value from the Profiling System.
DeleteProfileByKey Deletes a ProfileObject object specified by a key member/value pair from the Profiling System.
GetProfile Retrieves a ProfileObject object specified by a primary key value from the Profiling System.
GetProfileByKey Retrieves a ProfileObject object specified by a key member/value pair from the Profiling System.
GetProfileDefXML Retrieves the XML description of the specified profile definition.
Initialize Establishes connection to the specified Profiles store and populates the schema cache.
UnBind Clears the user credentials for accessing the underlying Profiles store.

[Visual Basic]

Method Description
BindAs Sets the user credentials for accessing the underlying Profiles store.
CreateProfile Creates the specified ProfileObject object.
CreateProfileXML Creates a ProfileObject object from XML data.
DeleteProfile Deletes a ProfileObject object specified by a primary key value from the Profiling System.
DeleteProfileByKey Deletes a ProfileObject object specified by a key member/value pair from the Profiling System.
GetProfile Retrieves a ProfileObject object specified by a primary key value from the Profiling System.
GetProfileByKey Retrieves a ProfileObject object specified by a key member/value pair from the Profiling System.
GetProfileDefXML Retrieves the XML description of the specified profile definition.
Initialize Establishes connection to the specified Profiles store and populates the schema cache.
UnBind Clears the user credentials for accessing the underlying Profiles store.

Properties

[C++]

Property Type Description
Errors Errors Stores the collection of errors encountered in the last Profiles resource operation.

This property is read-only.

[Visual Basic]

Property Type Description
Errors Object Stores the collection of errors encountered in the last Profiles resource operation.

This property is read-only.

Remarks

The ProfileService object implements read/write run-time access for ProfileObject objects and read-only access for profile definitions.

The ProfileService object provides run-time access to a profile object, which is a specific instantiation of a profile schema. The Profile definition designer module in Commerce Server Business Desk and the Profiles resource in Commerce Server Manager provide design-time access for modifying the profile schema.

In a Web-based application context, the ProfileService object is intended to be created and initialized in the Global.asa file for the application. The ProfileObject objects are intended to be created within page scope.

If you create a COM+ application, you cannot make calls from within that application to the ProfileService object.

Call the Initialize method before you use any other ProfileService method or property.

See Also

[C++]Profile Objects

[C++]Profile Schema

[C++]Profile XML Structures

[C++]ProfileObject Object

[Visual Basic]Profile Objects

[Visual Basic]Profile Schema

[Visual Basic]Profile XML Structures

[Visual Basic]ProfileObject Object

Copyright © 2005 Microsoft Corporation.
All rights reserved.