IDBStorage::InitStorage

The InitStorage method initializes a DBStorage object. You must call this method immediately after creating an instance of the DBStorage object, and before calling any other DBStorage object methods.

HRESULT InitStorage(
VARIANT vtDataSourceDSN,// in
BSTR Table,// in
BSTR bstrKey,// in
VARIANT vtProgID,// in
VARIANT vtMarshal,// in
VARIANT vtChanged// in
);

Parameters

vtDataSourceDSN
A VARIANT in which the pdispVal member references a valid IDispatch pointer on a DataSource object, or in which the BSTR pbstrVal member references a data source name (DSN).
bstrTable
A BSTR that references the table on which this DBStorage object instance will operate.
bstrKey
A BSTR that identifies the key for the table identified by Table.
vtProgID
The program identifier (ProgID) for the object to be used to pass data to and from this DBStorage object instance. Accepted values include “Commerce.Dictionary” and “Commerce.OrderForm”.
vtMarshal
The marshal column for the table identified in Table. See the “Remarks” section.
vtChanged
A BSTR VARIANT that specifies the date on which the change was made.

Include

<commerce.h>

Return Values

Value Description
S_OK The method succeeded.
E_FAIL The InitStorage method was invoked twice on the same object instance.
E_INVALIDARG The bstrTable or bstrKey parameters are NULL. Alternately, the vtDataSourceDSN parameter does not reference a valid Datasource object instance or data source name (DSN).


© 1997-1998 Microsoft Corporation. All rights reserved.