Partager via


IBCPSession::BCPReadFmt (OLE DB)

Lit les informations de format pour chaque colonne à partir du fichier de format.

Syntaxe

HRESULT BCPReadFmt( 
      const wchar_t *pwszFormatFile);

Notes

La méthode BCPReadFmt est utilisée pour lire les données d'un fichier de format qui spécifie le format des données dans le fichier de données. Cette méthode est capable de détecter la version correcte du fichier de format. Elle peut détecter automatiquement si le fichier de format est au format xml ou dans un ancien format et qu'il se comporte en conséquence. Les fichiers de format versions 6.0 et supérieures sont prises en charge par l'utilitaire de copie en bloc (BCP) du fournisseur OLE DB SQL Server Native Client.

Après avoir lu les valeurs de format, la méthode BCPReadFmt effectue les appels appropriés aux méthodes IBCPSession::BCPColumns et IBCPSession::BCPColFmt. L'utilisateur n'a pas besoin d'analyser un fichier de format et d'effectuer ces appels.

Pour enregistrer un fichier de format, appelez la méthode IBCPSession::BCPWriteFmt. Les appels à la méthode BCPReadFmt peuvent référencer des formats enregistrés. L'utilitaire BCP peut également enregistrer des formats de données définis par l'utilisateur dans des fichiers qui peuvent être référencés par la méthode BCPReadFmt.

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