Partager via


IBCPSession ::BCPWriteFmt (fournisseur OLE DB Native Client)

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Important

SQL Server Native Client (souvent abrégé en SNAC) a été supprimé dans SQL Server 2022 (16.x) et SQL Server Management Studio 19 (SSMS). Le fournisseur OLE DB pour SQL Server Native Client (SQLNCLI ou SQLNCLI11) et le fournisseur Microsoft OLE DB hérité pour SQL Server (SQLOLEDB) ne sont pas recommandés dans les nouveaux développements. Utilisez à la place le nouveau Microsoft OLE DB Driver (MSOLEDBSQL) pour SQL Server.

Écrit les informations de format pour chaque colonne dans le fichier de format.

Syntaxe

  
HRESULT BCPWriteFmt(   
      const wchar_t *pwszFormatFile);  

Notes

Le fichier de format spécifie le format de données d'un fichier de données créé par le biais d'une copie en bloc. Les appels aux méthodes IBCPSession::BCPColumns et IBCPSession::BCPColFmt définissent le format du fichier de données. La méthode BCPWriteFmt enregistre cette définition dans le fichier référencé par l'argument pwszFormatFile.

La méthode BCPWriteFmt peut enregistrer les fichiers de format dans un format XML ou texte. Vous devez l’indiquer au moyen de l’option de contrôle BCP_OPTION_XML avec la méthode IBCPSession::BCPControl.

Pour charger un fichier de format enregistré, utilisez la méthode IBCPSession::BCPReadFmt.

Arguments

pwszFormatFile[in]
Chemin d'accès et nom du fichier contenant les valeurs de format du fichier de données.

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_OUTOFMEMORY
Erreur de mémoire insuffisante.

E_UNEXPECTED
L'appel à la méthode était inattendu. Par exemple, la méthode IBCPSession::BCPInit n’a pas été appelée avant d’appeler cette méthode.

Voir aussi

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