表示专为高级使用而设计的访问器类型。
语法
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 ();
参数
请参阅“OLE DB 程序员参考”中的 DBBINDING。
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 ();
参数
请参阅“OLE DB 程序员参考”中的 DBBINDING。
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 类