Skip to content

Latest commit

 

History

History
191 lines (126 loc) · 5.62 KB

cmanualaccessor-class.md

File metadata and controls

191 lines (126 loc) · 5.62 KB
description title ms.date f1_keywords helpviewer_keywords ms.assetid
Learn more about: CManualAccessor Class
CManualAccessor Class
11/04/2016
ATL::CManualAccessor
ATL.CManualAccessor
CManualAccessor
ATL::CManualAccessor::AddBindEntry
ATL.CManualAccessor.AddBindEntry
CManualAccessor::AddBindEntry
CManualAccessor.AddBindEntry
CManualAccessor::AddParameterEntry
ATL.CManualAccessor.AddParameterEntry
CManualAccessor.AddParameterEntry
AddParameterEntry
ATL::CManualAccessor::AddParameterEntry
ATL::CManualAccessor::CreateAccessor
ATL.CManualAccessor.CreateAccessor
CManualAccessor.CreateAccessor
CManualAccessor::CreateAccessor
ATL::CManualAccessor::CreateParameterAccessor
ATL.CManualAccessor.CreateParameterAccessor
CManualAccessor.CreateParameterAccessor
CreateParameterAccessor
CManualAccessor::CreateParameterAccessor
CManualAccessor class
AddBindEntry method
AddParameterEntry method
CreateAccessor method
CreateParameterAccessor method
a0088074-7135-465c-b228-69097a50b8cc

CManualAccessor Class

Represents an accessor type designed for advanced use.

Syntax

class CManualAccessor : public CAccessorBase

Requirements

Header: atldbcli.h

Members

Methods

Name Description
AddBindEntry Adds a bind entry to the output columns.
AddParameterEntry Adds a parameter entry to the parameter accessor.
CreateAccessor Allocates memory for the column bind structures and initializes the column data members.
CreateParameterAccessor Allocates memory for the parameter bind structures and initializes the parameter data members.

Remarks

Using CManualAccessor, you can specify the parameter and output column binding by run-time function calls.

CManualAccessor::AddBindEntry

Adds a bind entry to the output columns.

Syntax

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

Parameters

See DBBINDING in the OLE DB Programmer's Reference.

nOrdinal
[in] Column number.

wType
[in] Data type.

nColumnSize
[in] Column size in bytes.

pData
[in] A pointer to the column data stored in the buffer.

pLength
[in] A pointer to the field length, if required.

pStatus
[in] A pointer to the variable to be bound to the column status, if required.

Remarks

To use this function, you must first call CreateAccessor. You cannot add more entries than the number of columns specified in CreateAccessor.

CManualAccessor::AddParameterEntry

Adds a parameter entry to the parameter entry structures.

Syntax

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

Parameters

See DBBINDING in the OLE DB Programmer's Reference.

nOrdinal
[in] Parameter number.

wType
[in] Data type.

nColumnSize
[in] Column size in bytes.

pData
[in] A pointer to the column data stored in the buffer.

pLength
[in] A pointer to the field length, if required.

pStatus
[in] A pointer to the variable to be bound to the column status, if required.

eParamIO
[in] Specifies whether the parameter with which the binding is associated is an input, input/output, or output parameter.

Remarks

To use this function, you must first call CreateParameterAccessor.

CManualAccessor::CreateAccessor

Allocates memory for the column bind structures and initializes the column data members.

Syntax

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

Parameters

nBindEntries
[in] Number of columns. This number should match the number of calls to the CManualAccessor::AddBindEntry function.

pBuffer
[in] A pointer to the buffer where the output columns are stored.

nBufferSize
[in] The size of the buffer in bytes.

Return Value

One of the standard HRESULT values.

Remarks

Call this function before you call the CManualAccessor::AddBindEntry function.

CManualAccessor::CreateParameterAccessor

Allocates memory for the parameter bind structures and initializes the parameter data members.

Syntax

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

Parameters

nBindEntries
[in] Number of columns.

pBuffer
[in] A pointer to the buffer where the input columns are stored.

nBufferSize
[in] The size of the buffer in bytes.

Return Value

One of the standard HRESULT values.

Remarks

You must call this function before calling AddParameterEntry.

See also

DBViewer
OLE DB Consumer Templates
OLE DB Consumer Templates Reference
CAccessor Class
CDynamicAccessor Class
CDynamicParameterAccessor Class