CCommand::Open
Wykonuje i opcjonalnie wiąże się polecenie.
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
[w] Sesja, w którym do wykonania polecenia.wszCommand
[w] Polecenie do wykonania, przekazywana jako ciąg Unicode.Może być wartości NULL podczas korzystania z CAccessor, w którym to przypadku polecenie zostanie pobrany z wartością przekazywaną do DEFINE_COMMAND makro.Zobacz ICommand::Execute w OLE DB Programmer's Reference Aby uzyskać szczegółowe informacje.szCommand
[w] Taki sam jak wszCommand z tym wyjątkiem, że ten parametr ma ciąg polecenia ANSI.Czwarty formularz tej metody może przyjąć wartość NULL.Patrz "Uwagi" w dalszej części tego tematu, aby uzyskać szczegółowe informacje.pPropSet
[w] Wskaźnik do tablicy DBPROPSET struktury zawierające właściwości i wartości, które można ustawić.Zobacz zestawy właściwości i grup właściwości w OLE DB Programmer's Reference w Windows SDK.pRowsAffected
[We/Wy] Wskaźnik do pamięci, gdzie liczba wierszy za pomocą polecenia jest zwracana.Jeśli * pRowsAffected jest wartości NULL, nie liczba wierszy jest zwracany.W przeciwnym razie Otwórz ustawia *pRowsAffected w następujących warunkach:Jeśli
Następnie
CParamSets element pParams jest większa niż 1
*pRowsAffected reprezentuje całkowita liczba wierszy dotyczy wszystkich zestawów parametrów określonych w realizacji.
Liczba wierszy nie jest dostępny
*pRowsAffected is set to –1.
Polecenie nie aktualizuje, usuwanie lub wstawianie wierszy
*pRowsAffected jest niezdefiniowane.
guidCommand
[w] Identyfikator GUID, który określa składni i ogólne zasady dostawca do używania podczas analizy tekstu polecenia.Zobacz ICommandText::GetCommandText i ICommandText::SetCommandText w OLE DB Programmer's Reference Aby uzyskać szczegółowe informacje.bBind
[w] Określa, czy automatycznie powiązać polecenie po aktualnie wykonywane.Wartością domyślną jest true, który powoduje, że polecenie na związanie się automatycznie.Ustawienie bBind do false uniemożliwia automatyczne powiązania polecenie tak, aby można powiązać ręcznie. (Ręczne powiązanie jest szczególnie przydatne dla użytkowników OLAP).ulPropSets
[w] Liczba DBPROPSET przekazany struktur pPropSet argument.
Wartość zwracana
Standard HRESULT.
Uwagi
Pierwsze trzy formy Otwórz podjąć sesji, utworzyć polecenie i wykonać polecenia wiążące wszystkie parametry w razie potrzeby.
W pierwszej postaci Otwórz pobiera ciąg polecenia Unicode i nie ma wartości domyślnej.
Druga forma Otwórz ciąg polecenia ANSI i żadnej wartości domyślnej (pod warunkiem zgodności z poprzednimi wersjami z istniejącymi aplikacjami ANSI).
Trzecia forma z Otwórz zezwala na wartość NULL, ponieważ typu ciąg polecenia int o wartości domyślnej null.Jest to przewidziane do nawiązywania połączeń z Open(session, NULL); lub Open(session); , ponieważ wartość NULL jest typu int.Ta wersja wymaga i twierdzi, że int parametr mieć wartość NULL.
Korzystać z czwartym formy Otwórz kiedy już została utworzona polecenia i chcesz wykonać jeden przygotowania i wykonania wielu.
[!UWAGA]
Otwórz wywołania Execute, który z kolei wywołuje GetNextResult.
Wymagania
Nagłówek: atldbcli.h