IProfileService2::GetProfile Method [C++]

Article
11/12/2009

Use this method to retrieve the ProfileObject object corresponding to the specified primary key value and schema type.

Definition

[C++]

HRESULT IProfileService::GetProfile(VARIANTsValue,
  BSTRbstrType,
  VARIANT_BOOLbReturnError,
  IProfileObject**ppProfileObject);

[Visual Basic]

Function GetProfile(sValue as Variant,
  bstrType As StringOptionalbReturnError As Boolean) As Object

Parameters

sValue [C++]
[in] A VARIANT that contains the primary key value.
sValue [Visual Basic]
[in] A Variant that contains the primary key value.
bstrType[C++]
[in] A BSTR that contains the profile schema type.
bstrType[Visual Basic]
[in] A String that contains the profile schema type.
bReturnError[C++]
[in, optional, defaultvalue (-1)] An optional VARIANT_BOOL.
bReturnError[Visual Basic]
[in] An optional Boolean. The default value is True (-1).
ppProfileObject[C++]
[out, retval] The address of a pointer to the IProfileObject interface of the returned ProfileObject object.

Return Values

[C++] This method returns an HRESULT indicating whether it completed successfully. See the Error Values section for more details.

[Visual Basic] If this method completes successfully, it returns a ProfileObject object corresponding to the specified primary key value and schema name.

Error Values

[C++] The Errors property stores the collection of errors encountered in the last Profiles resource operation. For more information, see IProfileService::get_Errors.

[Visual Basic] 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 GetProfileByKey method to retrieve a profile by specifying a key member name/value pair 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.

[C++]

The ppProfileObject parameter contains valid data only if the method completes successfully.