ProfileService Object

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

Note

The ProfileService object is obsolete; instead, use ProfileContext or ProfileManagementContext.

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

ProgID:

Commerce.ProfileService (Externally creatable)

COM Class Name:

ProfileService

Type Library Name:

Microsoft Commerce Server Profile Service Type Library

DLL Name:

mscsups.dll

Threading Model:

Both

COM Interface Name:

IProfileService2

Interface ID Constant:

IID_IProfileService2

Header File:

mscsups.h

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

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 Profiles System.

DeleteProfileByKey

Deletes a ProfileObject object specified by a key member/value pair from the Profiles System.

GetProfile

Retrieves a ProfileObject object specified by a primary key value from the Profiles System.

GetProfileByKey

Retrieves a ProfileObject object specified by a key member/value pair from the Profiles 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

Property

Description

Errors

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 Schema Manager 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

Other Resources

Profiles Schema

ProfileObject Object

COM Object Reference