Traitement des résultats

Si un objet d’ensemble de lignes est généré par l’exécution d’une commande ou la génération d’un objet d’ensemble de lignes directement à partir du fournisseur, le consommateur doit récupérer et accéder aux données dans l’ensemble de lignes.

Les ensembles de lignes sont les objets centraux qui permettent au fournisseur OLE DB SQL Server Native Client d’exposer des données sous forme tabulaire. Conceptuellement, un ensemble de lignes est un ensemble de lignes dans lequel chaque ligne a des données de colonne. Un objet rowset expose des interfaces telles que IRowset (contient des méthodes pour extraire des lignes de l’ensemble de lignes séquentiellement), IAccessor (permet la définition d’un groupe de liaisons de colonnes décrivant la façon dont les données tabulaires sont liées aux variables de programme consommateur), IColumnsInfo (fournit des informations sur les colonnes de l’ensemble de lignes) et IRowsetInfo (fournit des informations sur l’ensemble de lignes).

Un consommateur peut appeler la méthode IRowset ::GetData pour récupérer une ligne de données de l’ensemble de lignes dans une mémoire tampon. Avant d’appeler GetData , le consommateur décrit la mémoire tampon à l’aide d’un ensemble de structures DBBINDING. Chaque liaison décrit comment une colonne d’un ensemble de lignes est stockée dans une mémoire tampon du consommateur et contient les éléments suivants :

• Ordinal de la colonne (ou paramètre) à laquelle la liaison s’applique.

• Informations sur ce qui est lié (par exemple, valeur de données, longueur des données et état de liaison).

• Informations sur ce qui est décalé dans la mémoire tampon pour chacune de ces parties.

• Longueur et type des valeurs de données telles qu’elles existent dans la mémoire tampon du consommateur.

Lors de l’obtention des données, le fournisseur utilise des informations dans chaque liaison pour déterminer où et comment récupérer des données à partir de la mémoire tampon du consommateur. Lorsque vous définissez des données dans la mémoire tampon du consommateur, le fournisseur utilise des informations dans chaque liaison pour déterminer où et comment retourner des données dans la mémoire tampon du consommateur.

Une fois les structures DBBINDING spécifiées, un accesseur est créé (IAccessor ::CreateAccessor). Un accesseur est une collection de liaisons et est utilisé pour obtenir ou définir les données dans la mémoire tampon du consommateur.

Voir aussi

Création d’une application de fournisseur OLE DB SQL Server Native Client
Rubriques de procédures OLE DB