Partager via


IBCPSession::BCPWriteFmt (OLE DB)

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

Télécharger le pilote OLE DB

É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