IBCPSession::BCPReadFmt (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

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) d’OLE DB Driver pour SQL Server.

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'utilitairebcppeut é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 .

La valeur BCP_OPTION_DELAYREADFMT du paramètre eOption de IBCPSession::BCPControl modifie le comportement de 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