CManualAccessor, classe

Représente un type d’accesseur conçu pour une utilisation avancée.

Syntaxe

class CManualAccessor : public CAccessorBase

Spécifications

En-tête : atldbcli.h

Membres

Méthodes

Nom	Description
AddBindEntry	Ajoute une entrée de liaison aux colonnes de sortie.
AddParameterEntry	Ajoute une entrée de paramètre au accesseur de paramètre.
CreateAccessor	Alloue de la mémoire pour les structures de liaison de colonne et initialise les membres de données de colonne.
CreateParameterAccessor	Alloue de la mémoire pour les structures de liaison de paramètres et initialise les membres de données de paramètre.

Notes

À l’aide CManualAccessorde , vous pouvez spécifier la liaison de paramètre et de colonne de sortie par des appels de fonction au moment de l’exécution.

CManualAccessor::AddBindEntry

Ajoute une entrée de liaison aux colonnes de sortie.

Syntaxe

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

Paramètres

Consultez DBBINDING dans la référence du programmeur OLE DB.

nOrdinal
[in] Numéro de colonne.

wType
[in] Type de données.

nColumnSize
[in] Taille de colonne en octets.

pData
[in] Pointeur vers les données de colonne stockées dans la mémoire tampon.

pLength
[in] Pointeur vers la longueur du champ, si nécessaire.

pStatus
[in] Pointeur vers la variable à lier à l’état de colonne, si nécessaire.

Notes

Pour utiliser cette fonction, vous devez d’abord appeler CreateAccessor. Vous ne pouvez pas ajouter plus d’entrées que le nombre de colonnes spécifiées dans CreateAccessor.

CManualAccessor::AddParameterEntry

Ajoute une entrée de paramètre aux structures d’entrée de paramètre.

Syntaxe

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

Paramètres

Consultez DBBINDING dans la référence du programmeur OLE DB.

nOrdinal
[in] Numéro de paramètre.

wType
[in] Type de données.

nColumnSize
[in] Taille de colonne en octets.

pData
[in] Pointeur vers les données de colonne stockées dans la mémoire tampon.

pLength
[in] Pointeur vers la longueur du champ, si nécessaire.

pStatus
[in] Pointeur vers la variable à lier à l’état de colonne, si nécessaire.

eParamIO
[in] Spécifie si le paramètre avec lequel la liaison est associée est un paramètre d’entrée, d’entrée/sortie ou de sortie.

Notes

Pour utiliser cette fonction, vous devez d’abord appeler CreateParameterAccessor.

CManualAccessor::CreateAccessor

Alloue de la mémoire pour les structures de liaison de colonne et initialise les membres de données de colonne.

Syntaxe

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

Paramètres

nBindEntries
[in] Nombre de colonnes. Ce nombre doit correspondre au nombre d’appels à la fonction CManualAccessor ::AddBindEntry .

pBuffer
[in] Pointeur vers la mémoire tampon où les colonnes de sortie sont stockées.

nBufferSize
[in] Taille de la mémoire tampon en octets.

Valeur de retour

Une des valeurs HRESULT standard.

Notes

Appelez cette fonction avant d’appeler la CManualAccessor::AddBindEntry fonction.

CManualAccessor::CreateParameterAccessor

Alloue de la mémoire pour les structures de liaison de paramètres et initialise les membres de données de paramètre.

Syntaxe

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

Paramètres

nBindEntries
[in] Nombre de colonnes.

pBuffer
[in] Pointeur vers la mémoire tampon où les colonnes d’entrée sont stockées.

nBufferSize
[in] Taille de la mémoire tampon en octets.

Valeur de retour

Une des valeurs HRESULT standard.

Notes

Vous devez appeler cette fonction avant d’appeler AddParameterEntry.

Voir aussi

DBViewer
Modèles du consommateur OLE DB
Référence des modèles du consommateur OLE DB
CAccessor, classe
CDynamicAccessor, classe
CDynamicParameterAccessor, classe