namedRecordset method

  • Article

Retrieves the recordset object corresponding to the named data member from a data source object (DSO).

Syntax

IDispatch retVal = object.namedRecordset(dataMember, hierarchy);

Parameters

  • dataMember [in]
    Type: BSTR

    BSTR that specifies the name of the data member, or an empty string, which indicates the default data member.

  • hierarchy [in, optional]
    Type: VARIANT

    Address of a VARIANT of type VT_BSTR that specifies a path to a hierarchical data set. May be set to NULL.

Standards information

There are no standards that apply here.

Remarks

Valid names for a data member are specific to the DSO implementation. Check the DSO documentation to determine whether it supports named data members and to determine the valid names for those data members.

If NULL values or empty strings are passed to the IHTMLGenericElement::namedRecordset method, the default recordset is returned. This is identical to referring to the IHTMLGenericElement::recordset property directly.

If the second parameter is omitted, the top-level recordset is returned. If the first parameter is omitted but the second parameter is specified, the specified subchapter of the default recordset is returned.

See also

Using a Data Source Object that Exposes Multiple Data Members