Класс CManualAccessor

Представляет тип метода доступа, предназначенный для расширенного использования.

Синтаксис

class CManualAccessor : public CAccessorBase

Требования

Заголовок: atldbcli.h

Участники

Методы

Имя	Описание
AddBindEntry	Добавляет запись привязки к выходным столбцам.
AddParameterEntry	Добавляет запись параметра в метод доступа к параметру.
CreateAccessor	Выделяет память для структур привязки столбцов и инициализирует элементы данных столбца.
CreateParameterAccessor	Выделяет память для структур привязки параметров и инициализирует элементы данных параметров.

Замечания

С помощью CManualAccessorможно указать привязку параметра и выходного столбца с помощью вызовов функции во время выполнения.

CManualAccessor::AddBindEntry

Добавляет запись привязки к выходным столбцам.

Синтаксис

void AddBindEntry(DBORDINAL nOrdinal,
   DBTYPE wType,  DBLENGTH nColumnSize,
   void* pData,
   void* pLength = NULL,
   void* pStatus = NULL) throw ();

Параметры

См. раздел DBBINDING в справочнике программиста OLE DB.

nOrdinal
[in] Номер столбца.

wType
[in] Тип данных.

nColumnSize
[in] Размер столбца в байтах.

Pdata
[in] Указатель на данные столбца, хранящиеся в буфере.

pLength
[in] Указатель на длину поля при необходимости.

pStatus
[in] Указатель на переменную, привязанную к состоянию столбца при необходимости.

Замечания

Чтобы использовать эту функцию, необходимо сначала вызвать CreateAccessor. Не удается добавить больше записей, чем количество столбцов, указанных в CreateAccessor.

CManualAccessor::AddParameterEntry

Добавляет запись параметра в структуры входа параметров.

Синтаксис

void AddParameterEntry(DBORDINAL nOrdinal,
   DBTYPE wType,  DBLENGTH nColumnSize,
   void* pData,
   void* pLength = NULL,
   void* pStatus = NULL,
   DBPARAMIO eParamIO = DBPARAMIO_INPUT) throw ();

Параметры

См. раздел DBBINDING в справочнике программиста OLE DB.

nOrdinal
[in] Номер параметра.

wType
[in] Тип данных.

nColumnSize
[in] Размер столбца в байтах.

Pdata
[in] Указатель на данные столбца, хранящиеся в буфере.

pLength
[in] Указатель на длину поля при необходимости.

pStatus
[in] Указатель на переменную, привязанную к состоянию столбца при необходимости.

eParamIO
[in] Указывает, связан ли параметр, с которым связана привязка, является входным, входным и выходным или выходным параметром.

Замечания

Чтобы использовать эту функцию, необходимо сначала вызвать CreateParameterAccessor.

CManualAccessor::CreateAccessor

Выделяет память для структур привязки столбцов и инициализирует элементы данных столбца.

Синтаксис

HRESULT CreateAccessor(int nBindEntries,
  void* pBuffer,
   DBLENGTH nBufferSize) throw();

Параметры

nBindEntries
[in] Количество столбцов. Это число должно соответствовать количеству вызовов функции CManualAccessor::AddBindEntry .

pBuffer
[in] Указатель на буфер, в котором хранятся выходные столбцы.

nBufferSize
[in] Размер буфера в байтах.

Возвращаемое значение

Одно из стандартных значений HRESULT.

Замечания

Вызовите эту функцию перед вызовом CManualAccessor::AddBindEntry функции.

CManualAccessor::CreateParameterAccessor

Выделяет память для структур привязки параметров и инициализирует элементы данных параметров.

Синтаксис

HRESULT CreateParameterAccessor(int nBindEntries,
   void* pBuffer,
   DBLENGTH nBufferSize) throw();

Параметры

nBindEntries
[in] Количество столбцов.

pBuffer
[in] Указатель на буфер, в котором хранятся входные столбцы.

nBufferSize
[in] Размер буфера в байтах.

Возвращаемое значение

Одно из стандартных значений HRESULT.

Замечания

Перед вызовом AddParameterEntry необходимо вызвать эту функцию.

См. также

DBViewer
Шаблоны объекта-получателя OLE DB
Ссылка на шаблоны объекта-получателя OLE DB
Класс CAccessor
Класс CDynamicAccessor
Класс CDynamicParameterAccessor