GetProfileDomains Method

Artikkeli
11/12/2009

Returns an ADO Recordset object with a single column entitled "ADDomainName".

Namespace: Microsoft.CommerceServer.Interop.Profiles
Assembly: Microsoft.CommerceServer.Interop.Profiles.BizDataAdmin (in Microsoft.CommerceServer.Interop.Profiles.BizDataAdmin.dll)

Syntax

'Declaration
Public Function GetProfileDomains ( _
    ByRef profilePath As String _
) As Recordset

'Usage
Dim instance As BusinessDataAdminFreeThreaded
Dim profilePath As String
Dim returnValue As Recordset

returnValue = instance.GetProfileDomains(profilePath)

public Recordset GetProfileDomains(
    ref string profilePath
)

public:
Recordset^ GetProfileDomains(
    String^% profilePath
)

public function GetProfileDomains(
    profilePath : String
) : Recordset

Parameters

profilePath
Type: System..::.String%
The path the catalog to retrieve.

Return Value

Type: Recordset
An ADO Recordset with the profile-definition maps.

Exceptions

Exception	Condition
ERR_NOCONNECTION	The profile data store connection is not open.
ERR_PROFILEPATH_INVALID	Invalid source-path.

Remarks

Given the path to a specific profile, returns an ADO Recordset object with a single column entitled "ADDomainName". This recordset will contain information according to the following scenarios:

If the profile-definition maps to NO LDAPv3 sources then the recordset is empty.
If the profile-definition maps to a non-partitioned LDAPv3 source then the recordset contains the ADDomainName value for that source.
If the profile-definition maps to a partitioned LDAPv3 source but the profile does not have a hashing-key (i.e. it's not a partitioned profile) then the recordset contains one row with the AD domain- name for the default partition of that data-source.
If the profile-definition maps to a partitioned LDAPv3 source and the profile does have a hashing-key (i.e. it is a partitioned profile) then the recordset contains the AD domain-name for each partition in the data-source, ordered by source-name.

Permissions

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Jaa