Partager via


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

Autres ressources