IDBStorage::LookupData

The LookupData method retrieves a row of data based on a specified group of name/value pairs, and returns the resulting row of data (if any) in a Dictionary object.

Syntax

HRESULT LookupData(
VARIANT vtReserved,// in
VARIANT *pvtColumns,// in
VARIANT *pvtValues,// in
VARIANT *pvtRet// out
);

Parameters

vtReserved

Reserved for future use. LookupData ignores any value stored in this parameter.

pvtColumns

A VARIANT that identifies the columns in which to search for the data. This VARIANT can be either a SimpleList or a SAFEARRAY.

pvtValues

A VARIANT that identifies the values for which to search. Like the pvtColumns parameter, this parameter can be either a SimpleList or a SAFEARRAY.

pvtRet

If successful, pvtRet Points to a VARIANT that contains the result of the lookup, and this VARIANT's pdispValue references an IDispatch interface pointer on a Dictionary that contains the row data. Otherwise, pvtRet evaluates to NULL.

Include

<commerce.h>

Return Value

Related Topic

IDBStorage::LookupMultipleData