BF_TableOpen : ouverture d'une table

Prototype :
int BF_TableOpen (
      const string sBFName,
      const string sBFTableName,
      const string sBFDbName,
      const string sBFSrvName,
      const string sBFDbType,
      const string sBFParam = "");


sBFName
Nom interne de la table.
Ne doit pas être vide.
Ne doit pas contenir de caractère "."
Ce nom doit être unique.

sBFTableName
Nom réel de la table dans la base de données.

sBFDbName
Nom de la base de données.
Ne doit pas être vide sauf pour les bases BDB qui ne supportent qu'une table par base.

sBFSrvName
Nom du serveur ou adresse IP.
C'est le nom du fichier MDB pour les bases JET.
Est vide pour les bases BDB.

sBFDbType
Type de base de données.
Utilisez les constantes :
- BF_DB_ACCESS : pour les bases de données Microsoft Jet.
- BF_DB_SQLSERVER : pour les bases Microsoft SQL Server.
- BF_DB_MYSQL : pour les bases MySQL.
- BF_DB_BDB : pour les bases BDB en mode texte.

sBFParam
Chaine de caractère contenant les paramètres.
La chaine peut être vide.
Paramètres gérés : voir la page dédié aux paramètres

Valeur de retour
Est égal à 0, si aucune erreur est intervenue durant le déroulement de la fonction.
Sinon le code de l'erreur est retourné.

Divers
L'ouverture d'une table permet la lecture séquentielle des enregistrements.
On peut ouvrir plusieurs fois la même table, avec un nom interne différent.
Le mode "trusted connection" (récupération de l'identifiant Windows) est activé par défaut pour les bases SQLServer.
Le port par défaut est le 3306 pour les bases MySQL.
Si l'ouverture est réussie, il y a chargement automatique du type des champs de la table. (fonction BF_BDBRecordDescriptionLoad ou BF_BDBRecordDescriptionSave lancée automatiquement).
Une table ouverte doit être fermée ! (BF_TableClose).

Exemples
BF_TableOpen ("Matable1", "Matable1", "test.mdb", "", BF_DB_ACCESS, "");
=> ouverture d'une table Microsoft JET.

iError = BF_TableOpen ("Matable2", "products", "Northwind", "MonServeur", BF_DB_SQLSERVER, "USER=moi;PSW=toto");
=> ouverture d'une table Microsoft JET, sous le user "moi" et le mot de passe "toto".

iError = BF_TableOpen ("Matable3", "products", "Northwind", "MonServeur", BF_DB_SQLSERVER, "TRUST=true");
=> ouverture d'une table Microsoft JET, en récupérant l'identification Windows (trusted connection).

iError = BF_TableOpen ("Matable4", "matable", "testsql", "123.045.0.123", BF_DB_MYSQL351, "USER=moi;PSW=toto;PORT=12345");
=> ouverture d'une table MySQL Server, sous le user "moi" et le mot de passe "toto" avec le port 12345.