• Vrai si le positionnement sur l'enregistrement a été effectué,
• Faux en cas d'erreur. Ce problème peut être dû :
  • soit à un problème de positionnement (fichier de données vide, ...) : la fonction HTrouve renvoie Faux et la fonction HErreur renvoie 0.
  • soit à une erreur : la fonction HErreur renvoie un entier différent de 0. La fonction HErreurInfo permet d'obtenir plus de détails.

Nom du fichier de données manipulé. Si ce paramètre correspond à une chaîne vide (""), la fonction HPremier 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 clé utilisée pour parcourir le fichier de données. Si ce nom n'est pas spécifié, la fonction HPremier va manipuler la dernière rubrique de parcours utilisée sur ce fichier de données 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.

Paramètre le blocage réalisé sur l'enregistrement sélectionné par la fonction HPremier :

hBlocageNon	Aucun blocage (même si la fonction HDébutVerrou a été appelée) : l'enregistrement pourra être lu ou modifié par une autre application. Accès par JDBC : Cette constante n'est pas disponible.
hBlocageEcriture	Blocage en écriture : l'enregistrement sélectionné pourra être lu par une autre application mais ne pourra pas être modifié par une autre application. Accès par JDBC : Cette constante n'est pas disponible.
hBlocageLectureEcriture	Blocage en lecture/écriture : l'enregistrement sélectionné ne pourra ni être lu ni être modifié par une autre application. Blocage en écriture : l'enregistrement sélectionné pourra être lu par une autre application mais ne pourra pas être modifié par une autre application. Équivalent à la constante hBlocageEcriture. Accès par JDBC : Cette constante n'est pas disponible.
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 variable ne peut pas être utilisée.
hSansRafraîchir	Le contenu de la table ou de la requête ne sera pas rafraîchi. Toutes les positions sauvegardées sont conservées. Si ce paramètre n'est pas précisé, la fonction HPremier réinitialise le parcours pour la rubrique spécifiée : le contenu de la table ou de la requête est rafraîchi avec les données de la base de données OLE DB. Toutes les positions sauvegardées sont perdues. La restauration de la position sera effectuée à partir de la valeur de la meilleure rubrique. Remarque : Les parcours et les positions sauvegardées sur les autres rubriques ne sont jamais affectés.

La gestion des blocages est réalisée uniquement sur les fichiers de données HFSQL Client/Serveur ou manipulés par un Accès Natif. Il n'est pas possible de bloquer un enregistrement HFSQL Mobile. En effet, le système d'exploitation du Pocket PC ne permet pas de bloquer des enregistrements.

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

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

Le mode de blocage spécifié avec la fonction HPremier restera effectif lors des appels aux fonctions HPrécédent et HSuivant.

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

• soit les fonctions HRecherchePremier ou HRechercheDernier,
• soit les fonctions HPremier ou HDernier.
• soit les fonctions HBloqueNumEnr ou HDébloqueNumEnr.

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 blocage (fonction HBloqueNumEnr) conservées par compatibilité.