ProfileService Object

Ee810724.c++_off(en-US,CS.10).gifEe810724.vb_on(en-US,CS.10).gif

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

ProgID:   Commerce.ProfileService (Externally creatable)
COM Class Name:   ProfileService
COM Interface Name:   IProfileService
Interface ID Constant:   IID_IProfileService
Header File:   mscsups.h, mspu_guids.h
Type Library Name:   Microsoft Commerce 2000 Profile Service Type Library
DLL Name:   mscsups.dll
Threading Model:   Both

In C++, use the ProfileService 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.

The properties of the ProfileService object are shown in the following table.

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

This property is read-only.

The methods of the ProfileService object are shown in the following table.

Method Description
BindAs Sets the user credentials for accessing the underlying Profiles store.
CreateProfile Creates the specified ProfileObject object.
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.

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

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

See Also

Profile Objects

Profile Schema

Profile XML Structures

ProfileObject Object


All rights reserved.