IBCPSession::BCPColumns (OLE DB)
Définit le nombre de champs qui doivent être liés aux colonnes dans une table SQL Server.
Syntaxe
HRESULT BCPColumns(
DBCOUNTITEM nColumns);
Notes
En interne, il appelle IBCPSession::BCPColFmt afin de définir les valeurs par défaut pour les données du champ. Ces valeurs par défaut sont obtenues à partir des informations de colonne SQL Server que le fournisseur extrait en interne lorsque le nom de la table est spécifié par le biais de IBCPSession::BCPInit.
[!REMARQUE]
Cette méthode peut être appelée uniquement après que BCPInit a été appelé avec un nom de fichier valide.
Vous devez appeler cette méthode uniquement si vous envisagez d'utiliser un format de fichier utilisateur qui diffère du format 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 dans le fichier utilisateur afin de définir complètement un format de fichier personnalisé.
Arguments
- nColumns[in]
Nombre total de champs dans le fichier utilisateur. Même si vous vous préparez à copier en bloc les données provenant du fichier utilisateur dans une table SQL Server et n'envisagez pas de copier tous les champs dans le fichier utilisateur, vous devez définir l'argument nColumns en spécifiant le nombre total de champs de fichier utilisateur. Les champs omis peuvent alors être spécifiés par le biais de BCPColFmt.
Valeurs de code de retour
S_OK
La méthode a réussi.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. Cela se produit également lorsque cette méthode est appelée plus d'une fois pour une opération de copie en bloc.E_OUTOFMEMORY
Erreur de mémoire insuffisante.