CCommand::Open
Spustí a případně připojí 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 můžete provést příkaz.wszCommand
[v] Příkaz provedený, předány jako řetězec znaků Unicode.Může být NULL při použití CAccessor, v tom případě příkaz bude převzato z hodnota předaná DEFINE_COMMAND makro.Viz ICommand::Execute v OLE DB Programmer's Reference podrobnosti.szCommand
[v] Stejné jako wszCommand s výjimkou, že parametr příkazového řetězce ANSI.Čtvrtá forma této metody může nabývat hodnoty NULL.Viz "Poznámky" dále v tomto tématu pro podrobnosti.pPropSet
[v] Ukazatel na pole DBPROPSET struktury obsahující vlastnosti a hodnoty, které mají být nastaveny.Viz sady vlastností a vlastností skupiny v OLE DB Programmer's Reference v Windows SDK.pRowsAffected
[vstup/výstup] Ukazatel na paměti, pokud vrátí 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
Pak
CParamSets prvku pParams je větší než 1
*pRowsAffected představuje celkový počet řádků bylo ovlivněno všech sad parametrů podle provedení.
Počet ohrožených řádků není k dispozici
*pRowsAffected is set to –1.
Příkaz neprovede aktualizaci, odstranění nebo vkládání řádků
*pRowsAffected není definována.
guidCommand
[v] Identifikátor GUID, který určuje syntaxe a obecná pravidla pro poskytovatele pro použití v analýze text příkazu.Viz ICommandText::GetCommandText a ICommandText::SetCommandText v OLE DB Programmer's Reference podrobnosti.bBind
[v] Určuje, zda chcete vytvořit vazbu na příkaz automaticky po provedení.Výchozí hodnota je true, což způsobí, že příkaz automaticky svázat.Nastavení bBind k false zabrání automatické vazby příkaz tak, že můžete navázat ručně. (Ruční vazba je předmětem zvláštního zájmu pro uživatele OLAP).ulPropSets
[v] Počet DBPROPSET struktury předán pPropSet argument.
Vrácená hodnota
Standardní HRESULT.
Poznámky
První tři formy otevřených bude relace, příkaz Vytvořit a spustit příkaz, vazbu všech parametrů podle potřeby.
První tvar otevřených přijímá příkazový řetězec Unicode a nemá žádnou výchozí hodnotu.
Druhá forma otevřených přijímá příkazový řetězec ANSI a žádná výchozí hodnota (k dispozici z důvodu zpětné kompatibility se stávajícími aplikacemi ANSI).
Třetí forma otevřených umožňuje příkazový řetězec na hodnotu NULL, protože typ int s výchozí hodnotou Null.Je určen pro volání Open(session, NULL); nebo Open(session); protože je NULL typu int.Tato verze vyžaduje a tvrzení, že int mít parametr hodnotu NULL.
Čtvrtá forma se používá otevřených Pokud již máte vytvořený příkaz a budete chtít provést jednu Příprava a spuštění více.
[!POZNÁMKA]
Otevřít volání Execute, která zase volá GetNextResult.
Požadavky
Záhlaví: také atldbcli.h