IBCPSession::BCPWriteFmt (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.
[!REMARQUE]
Le fichier de format produit par la méthode BCPWriteFmt est pris en charge uniquement dans les versions de l'utilitaire bcp distribuées avec la version 7.0 ou ultérieure de SQL Server.
Arguments
- pwszFormatFile[in]
Chemin d'accès et nom du fichier contenant les valeurs de format du fichier de données.
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_OUTOFMEMORY
Erreur de mémoire insuffisante.E_UNEXPECTED
L'appel de 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
Concepts
Exécution d'opérations de copie en bloc