IBCPSession ::BCPReadFmt (OLE DB)

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

Syntaxe

  
HRESULT BCPReadFmt(   
const wchar_t *pwszFormatFile);  

Remarques

La méthode BCPReadFmt est utilisée pour lire des données à partir 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. Il peut détecter automatiquement si le fichier de format est au format xml ou au format texte de style ancien et se comporte en conséquence. Les versions de fichier de format prises en charge par le fournisseur OLE DB SQL Server Native Client sont la version 6.0 ou ultérieure.

Une fois que la méthode BCPReadFmt lit les valeurs de format, elle effectue les appels appropriés aux méthodes IBCPSession ::BCPColumns et IBCPSession ::BCPColFmt . Il n’est pas nécessaire que l’utilisateur analyse un fichier de format et effectue 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 de copie en bloc (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 .

La BCP_OPTION_DELAYREADFMT valeur du paramètre eOptiond’IBCPSession ::BCPControl modifie le comportement d’IBCPSession ::BCPReadFmt.

Les arguments

pwszFormatFile[in]
Chemin d’accès et nom de fichier 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 des informations détaillées à l’aide de l’interface ISQLServerErrorInfo .

E_OUTOFMEMORY
Erreur de mémoire insuffisante.

ERREUR_IMPRÉVUE
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