Correspond à :

• Faux en cas d'erreur. Dans ce cas, la fonction HErreur renvoie un entier différent de 0. La fonction HErreurInfo permet d'obtenir plus de détails sur l'erreur. L'enregistrement n'est pas lu.
• la valeur de la fonction HTrouve dans les autres cas (l'enregistrement peut être lu, même si <Résultat> renvoie Faux).

Nom du fichier de données, de la vue HFSQL ou de la requête manipulé. Si ce paramètre correspond à une chaîne vide (""), la fonction HLitPremier manipule le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).

Nom de la rubrique utilisée pour parcourir le fichier de données ou la vue (ce paramètre n'est pas pris en compte pour les requêtes). Si ce nom n'est pas spécifié, la fonction HLitPremier va utiliser :

• Dans le cas d'un fichier de données : la dernière rubrique de parcours utilisée sur ce fichier par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H). Si cette rubrique n'existe pas, la meilleure rubrique de parcours est automatiquement utilisée.
• Dans le cas d'une requête : le ORDER BY de la requête si il existe, sinon selon la dernière rubrique utilisée.
• Dans le cas d'une vue : la rubrique de tri de la vue (si elle existe), sinon sur la dernière rubrique utilisée.

Permet de paramétrer :

• le blocage réalisé sur l'enregistrement lu par la fonction HLitPremier
• la prise en compte ou non du filtre précédemment défini.

hBlocageEcriture	Blocage en écriture : l'enregistrement en cours de lecture pourra être lu par une autre application mais ne pourra pas être modifié par une autre application. Cette constante n'est pas disponible. Accès par JDBC : Cette constante n'est pas disponible.
hBlocageLectureEcriture	Blocage en lecture/écriture : l'enregistrement en cours de lecture ne pourra ni être lu ni être modifié par une autre application. Blocage en écriture seulement. Fonctionnement équivalent à la constante hBlocageEcriture. Cette constante n'est pas disponible. Accès par JDBC : Cette constante n'est pas disponible.
hBlocageNon	Aucun blocage : l'enregistrement pourra être lu ou modifié par une autre application pendant la lecture. Cette constante n'est pas disponible. Accès par JDBC : Cette constante n'est pas disponible.
hForwardOnly	Constante utilisable uniquement avec les Connecteurs Natifs. Permet d'accélérer le parcours des données lors d'un parcours simple qui n'utilise pas les fonctionnalités suivantes : Lecture de l'enregistrement précédent. Modification d'un enregistrement. Sauvegarde de position. Si une de ces fonctionnalités est utilisée, le résultat peut être différent de celui attendu. Cette constante peut par exemple être utilisée lors d'un parcours permettant de remplir un champ Table par programmation.
hRespecteFiltre	Le parcours prendra en compte le filtre mis en place avec la fonction HFiltre, même si la clé de parcours utilisée n'est pas optimisée pour le filtre. Rappel : la fonction HFiltre renvoie la clé de parcours optimisée pour le filtre. Attention : dans ce cas, sur des fichiers de données de taille importante, des problèmes de performances peuvent survenir. Cette constante ne peut pas être utilisée.
hSansRafraîchir	La fonction HLitPremier ne rafraîchit pas le contenu de la table ou de la requête. Dans la mesure du possible, la requête n'est pas ré-exécutée. Toutes les positions sauvegardées sont conservées.

Si le provider OLE DB ou le Connecteur Natif utilisé ne gère pas les blocages, les options de blocage seront sans effet.

Le mode de blocage spécifié avec la fonction HLitPremier restera effectif lors des appels aux fonctions HLitPrécédent et HLitSuivant.

Pour modifier le mode de blocage, il est nécessaire d'utiliser :

• soit les fonctions HLitRecherchePremier ou HLitRechercheDernier,
• soit les fonctions HLitDernier ou HLitPremier.
• soit les fonctions HBloqueNumEnr ou HDébloqueNumEnr.

Pour le Connecteur Natif Oracle, il est possible de spécifier un mode de blocage différent pour chaque enregistrement. Cependant, si une transaction a été démarrée à l'aide de la fonction SQLTransaction avant de procéder au blocage, le blocage ne sera relâché qu'à la fin de la transaction (fonction SQLTransaction avec la constante sqlFin ou sqlAnnule).

Les options de blocage ne sont pas prises en compte. Utilisez des fonctions de lecture bloquantes (fonction HLitPremierBloque) conservées par compatibilité.

Les options de blocage ne sont pas disponibles.

Accès par JDBC : La gestion des blocages n'est pas disponible sur les bases de données accédées par JDBC.