CCommand::Open
Spustí a volitelně vazba příkaz.
HRESULT Open(
const CSession& session,
LPCWSTR wszCommand,
DBPROPSET *pPropSet = NULL,
DBROWCOUNT* pRowsAffected = NULL,
REFGUID guidCommand = DBGUID_DEFAULT,
bool bBind = true,
ULONG ulPropSets = 0
) throw( );
HRESULT Open(
const CSession& session,
LPCSTR szCommand,
DBPROPSET *pPropSet = NULL,
DBROWCOUNT* pRowsAffected = NULL,
REFGUID guidCommand = DBGUID_DEFAULT,
bool bBind = true,
ULONG ulPropSets = 0
) throw( );
HRESULT Open(
const CSession& session,
INT szCommand = NULL,
DBPROPSET *pPropSet = NULL,
DBROWCOUNT* pRowsAffected = NULL,
REFGUID guidCommand = DBGUID_DEFAULT,
bool bBind = true,
ULONG ulPropSets = 0
) throw( );
HRESULT Open(
DBPROPSET *pPropSet = NULL,
DBROWCOUNT* pRowsAffected = NULL,
bool bBind = true,
ULONG ulPropSets = 0
) throw( );
Parametry
session
[v] Relace, ve kterém chcete provést příkaz.wszCommand
[v] Příkaz provedený, předán jako řetězec ve formátu Unicode.Může být NULL při použití CAccessor, v tom případě příkaz bude převzato z hodnoty předány DEFINE_COMMAND makro.Viz ICommand::Execute v OLE DB Programmer's Reference podrobnosti.szCommand
[v] Stejné jako wszCommand s výjimkou, že parametr příkazu řetězec ANSI.Čtvrtý formulář této metody může převzít hodnotu NULL.Dále v tomto tématu podrobnosti viz "Poznámky".pPropSet
[v] Ukazatel na pole DBPROPSET struktury obsahující vlastnosti a hodnoty nastavení.Viz sady vlastností a vlastností skupiny v OLE DB Programmer's Reference v Windows SDK.pRowsAffected
[vstup/výstup] Ukazatel na paměti, kde se vrací počet řádků bylo ovlivněno příkazem.Pokud * pRowsAffected je NULL, je vrácena žádná počet řádků.Jinak otevřených nastaví *pRowsAffected za následujících podmínek:Pokud
Potom
CParamSets prvku pParams je větší než 1
*pRowsAffected představuje celkový počet řádků, které jsou ovlivněny všechny sad parametrů v provedení.
Počet ovlivněných řádků není k dispozici
*pRowsAffected is set to –1.
Příkaz Aktualizovat, odstranit nebo vložit řádky
*pRowsAffected nedefinovaná.
guidCommand
[v] Identifikátor GUID Určuje syntaxi a obecná pravidla pro zprostředkovatele používat v analýze textu příkazu.Viz ICommandText::GetCommandText a ICommandText::SetCommandText v OLE DB Programmer's Reference podrobnosti.bBind
[v] Určuje, zda chcete svázat příkaz automaticky po spuštěn.Výchozí hodnota je true, který způsobí, že příkaz automaticky vázat.Nastavení bBind na false zabrání automatické vazby příkaz tak, aby bylo možné navázat ručně.(Ruční vazba je zvláštním zájmem uživatelů OLAP).ulPropSets
[v] Počet DBPROPSET struktury předána pPropSet argument.
Vrácená hodnota
Standard HRESULT.
Poznámky
První tři formy otevřených převzít relace, příkaz Vytvořit a provést příkaz, závazné parametry podle potřeby.
První tvar otevřených přebírá řetězec Unicode příkazu a nemá výchozí hodnotu.
Druhý formulář z otevřených přebírá řetězec příkazu ANSI a neexistuje žádná výchozí hodnota (z důvodu zpětné kompatibility s existujícími aplikacemi ANSI).
Třetí forma otevřených umožňuje příkazový řetězec NULL, bude z důvodu typu int s výchozí hodnotou Null.Stanovené volací Open(session, NULL); nebo Open(session); protože je NULL typu int.Tato verze vyžaduje a nepodmíněných výrazů, které int mít parametr hodnotu NULL.
Použít čtvrtou formu otevřených po příkazu jste již vytvořili a chcete provést jeden připravit a několika spuštěních nástroje.
[!POZNÁMKA]
Otevřít volání spouštět, který zavolá GetNextResult.
Požadavky
Záhlaví: atldbcli.h