ProfileService.GetProfileByKey

Article
06/07/2013

Ee810974.c++_on(en-US,CS.10).gif

Use this method to retrieve a ProfileObject object that corresponds to a specified key member name/value pair and schema type.

Definition

Function GetProfileByKey(bstrKeyMemberName As String,sValue As Variant,bstrType As StringOptionalbReturnError As Boolean) As Object

Parameters

bstrKeyMemberName

[in] A String that contains the key member name.

sValue

[in] A Variant that contains the key value.

bstrType

[in] A String that contains the schema type.

bReturnError

[in] An optional Boolean. The default value is True (-1).

Return Values

If this method completes successfully, it returns a ProfileObject object corresponding to the specified key member/value pair and schema name.

Error Values

The Errors property stores the collection of errors encountered in the last Profiles resource operation. For more information, see ProfileService.Errors.

Remarks

If the optional bReturnError parameter is set to True (-1) and the specified ProfileObject object is not found, an error message, E_PS_PROFILE_NOTEXISTS, is returned instead of a ProfileObject object.

If the bReturnError parameter is set to False (0) and the specified ProfileObject object is not found, an empty ProfileObject object is returned without an error message.

Properties with the IsCached attribute set to False are not loaded by this method.

The Fields property of the returned ProfileObject object provides access to the profile properties.

Use the GetProfile method to retrieve a profile by specifying a primary key value and schema type.

Call the Initialize method before you use this ProfileService method.

For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.

Example

' oProfileService is a Commerce ProfileService object
' oProfileObject is a Commerce ProfileObject object

oProfileObject = oProfileService.GetProfileByKey("user_id", _
 "{74A38551-D6D8-FFD0-12BF-0A20C90DC8D1}", "UserObject")