Microsoft OLE DB 2.0 Programmers Reference and Data Access SDK (Microsoft Professional Editions)
| 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.