CBookmark 类

在其缓冲区中保存书签值。

语法

template < DBLENGTH nSize = 0 >
class CBookmark : public CBookmarkBase

template <>
class CBookmark< 0 > : public CBookmarkBase

参数

nSize
书签缓冲区的大小（以字节为单位）。 nSize 为零时，将在运行时动态创建书签缓冲区。

要求

标头: atldbcli.h

成员

方法

名称	描述
CBookmark	构造函数
GetBuffer	检索指向缓冲区的指针。
GetSize	检索缓冲区的大小（以字节为单位）。
SetBookmark	设置书签值。

运算符

名称	描述
operator =	将一个 CBookmark 类分配给另一个类。

备注

CBookmark<0> 是 CBookmark 的模板专用化；其缓冲区在运行时动态创建。

CBookmark::CBookmark

构造函数。

语法

CBookmark();
CBookmark(DBLENGTH nSize);

参数

nSize
[in] 书签缓冲区的大小（以字节为单位）。

注解

第一个函数将缓冲区设置为 NULL 并将缓冲区大小设置为 0。 第二个函数将缓冲区大小设置为 nSize，并将缓冲区设置为 nSize 字节的字节数组。

注意

此函数只能在 CBookmark<0> 中使用。

CBookmark::GetBuffer

检索指向书签缓冲区的指针。

语法

virtual BYTE* GetBuffer() const throw();

返回值

指向书签缓冲区的指针。

CBookmark::GetSize

检索书签缓冲区的大小。

语法

virtual DBLENGTH GetSize() const throw();

返回值

缓冲区的大小（字节）。

CBookmark::SetBookmark

将 pBuffer 引用的书签值复制到 CBookmark 缓冲区，并将缓冲区大小设置为 nSize。

语法

HRESULT SetBookmark(DBLENGTH nSize, BYTE* pBuffer) throw();

参数

nSize
[in] 书签缓冲区的大小。

pBuffer
[in] 指向包含书签值的字节数组的指针。

返回值

标准 HRESULT。

注解

此函数只能在 CBookmark<0> 中使用。

CBookmark::operator =

将一个 CBookmark 对象分配给其他对象。

语法

CBookmark& operator =(const CBookmark& bookmark) throw();

备注

仅 CBookmark<0> 中需要此运算符。

另请参阅

OLE DB 使用者模板
OLE DB 使用者模板参考