ICommandPersist::LoadCommand

OLE DB Programmer's Reference

Loads a persisted command definition.

HRESULT LoadCommand(    DBID    *pCommandID,    DWORD    dwFlags);

Parameters

pCommandID

[in]
The DBID of the command to load.

dwFlags

[in]
Reserved for future use. Consumers should set this value to zero. Providers should ignore this argument.

Return Code

S_OK

The command was successfully loaded.

E_OUTOFMEMORY

There is not enough memory to successfully load the command.

DB_E_OBJECTOPEN

A rowset was open on the command.

DB_E_BADCOMMANDID

The command specified in *pCommandID does not exist.

E_FAIL

A provider-specific error occurred.

E_INVALIDARG

pCommandID was a null pointer, or dwFlags was not zero.

Comments

ICommandPersist::LoadCommand loads the persisted command definition into the current command object. Loading a persisted command definition does not change the command object's transaction scope and semantics nor does it change the session scope. Set property values and specified parameter information are not affected by loading a persisted command definition. ICommandPersist::LoadCommand fails if the current command object has any outstanding rowsets (DB_E_OBJECTOPEN).

1998-2001 Microsoft Corporation. All rights reserved.