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