Udostępnij za pośrednictwem

CCommand::Open

  • Artykuł

Wykonuje i opcjonalnie wiąże polecenia.

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 polecenie.

  • wszCommand
    [w] Polecenie do wykonania, jest przekazywana jako ciąg w formacie Unicode.Może być NULL podczas korzystania z CAccessor, w którym to przypadku polecenie zostaną pobrane z wartością przekazywaną do DEFINE_COMMAND makro.Zobacz ICommand::Execute w OLE DB Programmer's Reference Aby uzyskać szczegółowe informacje.

  • szCommand
    [w] Podobnie jak wszCommand z wyjątkiem, że ten parametr ciągu polecenia ANSI.Czwarty formularza tej metody można podjąć 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, należy ustawić.Zobacz zestawy właściwości i właściwość grupy w OLE DB Programmer's Reference w Windows SDK.

  • pRowsAffected
    [in/out] Wskaźnik do pamięci, gdzie jest zwracana liczba wierszy, polecenie dotyczy.Jeśli * pRowsAffected jest NULL, liczba wierszy nie jest zwracany.W przeciwnym razie Otwórz ustawia *pRowsAffected zgodnie z następującymi warunkami:

    Jeżeli

    Następnie

    CParamSets elementu pParams jest większa niż 1

    *pRowsAffected przedstawia łączną liczbę wierszy, które dotyczy wszystkich zestawów parametrów określonych w realizacji.

    Liczba wierszy, których dotyczy luka, nie jest dostępna

    *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 użyć dostawcy 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 wykonywany.Wartością domyślną jest true, co 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 przedmiotem szczególnego zainteresowania użytkownikom OLAP).

  • ulPropSets
    [w] Liczba DBPROPSET przekazany struktur pPropSet argument.

Wartość zwracana

Standard HRESULT.

Uwagi

Pierwsze trzy formy Otwórz podjąć sesji, polecenie Utwórz i wykonanie polecenia, wiążące wszystkie parametry w razie potrzeby.

W pierwszym formularzu 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).

Trzeci formie Otwórz pozwala ciąg polecenia się wartość NULL, ponieważ typ int z domyślną wartość NULL.Jest to przewidziane wywołania Open(session, NULL); lub Open(session); , ponieważ wartość NULL jest typu int.Ta wersja wymaga i potwierdza, że int parametr być NULL.

Formularz czwarty z Otwórz kiedy utworzono już polecenia i chcesz wykonać jeden Przygotuj i wielu egzekucji.

[!UWAGA]

Otwórz wywołania Execute, który z kolei wywołuje GetNextResult.

Wymagania

Nagłówek: atldbcli.h

Zobacz też

Informacje

Klasa CCommand