ICommandImpl — Klasa

Zapewnia implementację interfejsu ICommand .

Składnia

template <class T, class CommandBase = ICommand>
class ATL_NO_VTABLE ICommandImpl : public CommandBase

Parametry

T
Klasa pochodząca z ICommandImplklasy .

CommandBase
Interfejs polecenia. Wartość domyślna to ICommand.

Wymagania

Nagłówek: atldb.h

Członkowie

Metody

Nazwa/nazwisko	opis
Anuluj	Anuluje bieżące wykonanie polecenia.
CancelExecution	Anuluje bieżące wykonanie polecenia.
CreateRowset	Tworzy obiekt zestawu wierszy.
Execute	Wykonuje polecenie .
GetDBSession	Zwraca wskaźnik interfejsu do sesji, która utworzyła polecenie.
ICommandImpl	Konstruktor.

Składowe danych

Nazwa/nazwisko	opis
m_bCancel	Wskazuje, czy polecenie ma zostać anulowane.
m_bCancelWhenExecuting	Wskazuje, czy polecenie ma zostać anulowane podczas wykonywania.
m_bIsExecuting	Wskazuje, czy polecenie jest obecnie wykonywane.

Uwagi

Obowiązkowy interfejs w obiekcie polecenia.

ICommandImpl::Cancel

Anuluje bieżące wykonanie polecenia.

Składnia

STDMETHOD(Cancel)();

Uwagi

Zobacz ICommand::Cancel w dokumentacji programisty OLE DB.

ICommandImpl::CancelExecution

Anuluje bieżące wykonanie polecenia.

Składnia

HRESULT CancelExecution();

ICommandImpl::CreateRowset

Wywoływana przez polecenie Execute w celu utworzenia pojedynczego zestawu wierszy.

Składnia

template template <class RowsetClass>
HRESULT CreateRowset(IUnknown* pUnkOuter,
   REFIID riid,
   DBPARAMS* pParams,
   DBROWCOUNT* pcRowsAffected,
   IUnknown** ppRowset,
   RowsetClass*& pRowsetObj);

Parametry

Klasa RowsetClass
Składowa klasy szablonu reprezentująca klasę zestawu wierszy użytkownika. Zazwyczaj generowane przez kreatora.

pUnkOuter
[in] Wskaźnik do interfejsu sterującego IUnknown , jeśli zestaw wierszy jest tworzony w ramach agregacji; w przeciwnym razie ma wartość null.

Riid
[in] Odpowiada riid w .ICommand::Execute

pParams
[in/out] Odpowiada parametrom pParams w pliku ICommand::Execute.

pcRowsAffected
Odpowiada pcRowsAffected w .ICommand::Execute

ppRowset
[in/out] Odpowiada ppRowset w pliku ICommand::Execute.

pRowsetObj
[out] Wskaźnik do obiektu zestawu wierszy. Zazwyczaj ten parametr nie jest używany, ale może być używany, jeśli musisz wykonać więcej pracy na zestawie wierszy przed przekazaniem go do obiektu COM. Okres istnienia pRowsetObj jest powiązany przez element ppRowset.

Wartość zwracana

Standardowa wartość HRESULT. Zobacz ICommand::Execute listę typowych wartości.

Uwagi

Aby utworzyć więcej niż jeden zestaw wierszy lub zapewnić własne warunki tworzenia różnych zestawów wierszy, umieść różne wywołania z CreateRowset poziomu .Execute

Zobacz ICommand::Execute w dokumentacji programisty OLE DB.

ICommandImpl::Execute

Wykonuje polecenie .

Składnia

HRESULT Execute(IUnknown* pUnkOuter,
   REFIID riid,
   DBPARAMS* pParams,
   DBROWCOUNT* pcRowsAffected,
   IUnknown** ppRowset);

Parametry

Zobacz ICommand::Execute w dokumentacji programisty OLE DB.

Uwagi

Żądany interfejs wychodzący będzie interfejsem uzyskanym z obiektu zestawu wierszy, który tworzy ta funkcja.

Execute wywołuje metodę CreateRowset. Zastąpij domyślną implementację, aby utworzyć więcej niż jeden zestaw wierszy lub udostępnić własne warunki tworzenia różnych zestawów wierszy.

ICommandImpl::GetDBSession

Zwraca wskaźnik interfejsu do sesji, która utworzyła polecenie.

Składnia

STDMETHOD (GetDBSession) (REFIID riid,
   IUnknown** ppSession);

Parametry

Zobacz ICommand::GetDBSession w dokumentacji programisty OLE DB.

Uwagi

Przydatne do pobierania właściwości z sesji.

ICommandImpl::ICommandImpl

Konstruktor.

Składnia

ICommandImpl();

ICommandImpl::m_bCancel

Wskazuje, czy polecenie zostało anulowane.

Składnia

unsigned m_bCancel:1;

Uwagi

Tę zmienną można pobrać w Execute metodzie klasy poleceń i anulować odpowiednio.

ICommandImpl::m_bCancelWhenExecuting

Wskazuje, czy polecenie można anulować podczas wykonywania.

Składnia

unsigned m_bCancelWhenExecuting:1;

Uwagi

Wartości domyślne ( true można anulować).

ICommandImpl::m_bIsExecuting

Wskazuje, czy polecenie jest obecnie wykonywane.

Składnia

unsigned m_bIsExecuting:1;

Uwagi

Execute Metoda klasy poleceń może ustawić tę zmienną na truewartość .

Zobacz też

Szablony dostawców OLE DB
Architektura szablonu dostawcy OLE DB