IBCPSession ::BCPColumns (OLE DB)

Définit le nombre de champs à lier aux colonnes d’une table SQL Server.

Syntaxe

  
HRESULT BCPColumns(   
DBCOUNTITEMnColumns);  

Remarques

En interne, il appelle IBCPSession ::BCPColFmt pour définir les valeurs par défaut pour les données de champ. Ces valeurs par défaut sont obtenues à partir des informations de colonne SQL Server que le fournisseur récupère en interne lorsque le nom de la table est spécifié via IBCPSession ::BCPInit.

Vous devez appeler cette méthode uniquement si vous envisagez d’utiliser un format de fichier utilisateur différent de la valeur par défaut. Pour plus d’informations sur une description du format de fichier utilisateur par défaut, consultez la méthode BCPInit .

Après avoir appelé la méthode BCPColumns , vous devez appeler la méthode BCPColFmt pour chaque colonne du fichier utilisateur pour définir complètement un format de fichier personnalisé.

Les arguments

nColumns[in]
Nombre total de champs dans le fichier utilisateur. Même si vous préparez à copier en bloc des données du fichier utilisateur vers une table SQL Server et que vous n’avez pas l’intention de copier tous les champs du fichier utilisateur, vous devez toujours définir l’argument nColumns sur le nombre total de champs de fichier utilisateur. Les champs ignorés peuvent ensuite être spécifiés via BCPColFmt.

Codet de retour

S_OK
S_OK

E_FAIL
Une erreur spécifique au fournisseur s’est produite ; pour obtenir des informations détaillées, utilisez l’interface ISQLServerErrorInfo .

E_UNEXPECTED
L'appel à la méthode était inattendu. Par exemple, la méthode BCPInit n'a pas été appelée avant cette méthode. Se produit également lorsque cette méthode est appelée plusieurs fois pour une opération de copie en bloc.

E_OUTOFMEMORY
Erreur de mémoire insuffisante.

Voir aussi

IBCPSession (OLE DB)
Exécution d’opérations de copie en bloc