Partilhar via


Classe CBookmark

Retém um valor de indicador em seu buffer.

Sintaxe

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

template <>
class CBookmark< 0 > : public CBookmarkBase

Parâmetros

nSize
O tamanho do buffer de indicador em bytes. Quando nSize for zero, o buffer de indicador será criado dinamicamente em tempo de execução.

Requisitos

Cabeçalho: atldbcli.h

Membros

Métodos

Nome Descrição
CBookmark O construtor
GetBuffer Recupera o ponteiro para o buffer.
GetSize Recupera o tamanho do buffer em bytes.
SetBookmark Define o valor do indicador.

Operadores

Nome Descrição
operador = Atribui uma classe de CBookmark a outro.

Comentários

CBookmark<0> é uma especialização de modelo de CBookmark; seu buffer é criado dinamicamente em tempo de execução.

CBookmark::CBookmark

O construtor .

Sintaxe

CBookmark();
CBookmark(DBLENGTH nSize);

Parâmetros

nSize
[in] Tamanho do buffer de indicador em bytes.

Comentários

A primeira função define o buffer como NULL e o tamanho do buffer como 0. A segunda função define o tamanho do buffer como nSize, e o buffer como uma matriz de bytes de nSize bytes.

Observação

Essa função só está disponível em CBookmark<0>.

CBookmark::GetBuffer

Recupera o ponteiro para o buffer de indicador.

Sintaxe

virtual BYTE* GetBuffer() const throw();

Valor retornado

Um ponteiro para o buffer de indicador.

CBookmark::GetSize

Recupera o tamanho do buffer de indicador.

Sintaxe

virtual DBLENGTH GetSize() const throw();

Valor retornado

O tamanho do buffer em bytes.

CBookmark::SetBookmark

Copia o valor do indicador referenciado por pBuffer para o buffer CBookmark e define o tamanho do buffer como nSize.

Sintaxe

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

Parâmetros

nSize
[in] O tamanho do buffer de indicador.

pBuffer
[in] Um ponteiro para a matriz de bytes que contém o valor do indicador.

Valor de retorno

Um valor HRESULT padrão.

Comentários

Essa função só está disponível em CBookmark<0>.

CBookmark::operator =

Atribui um objeto CBookmark a outro.

Sintaxe

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

Comentários

Esse operador é necessário somente em CBookmark<0>.

Confira também

Modelos de consumidor OLE DB
Referência de modelos de consumidor do OLE DB