Iresultset

sélectionne l’entrée suivante, remplace isc_dsql_fetch(). Cette méthode (et d’autres méthodes de récupération) renvoie le code de complétion Status::RESULT_NO_DATA lorsque l’EOF est atteint, et le statut Status::RESULT_OK lorsqu’il réussit.

Sélectionne l’enregistrement précédent.

Sélectionne la première entrée.

Sélectionne la dernière entrée.

Récupère l’enregistrement à la position absolue dans le jeu de résultats.

Récupère l’enregistrement par position par rapport à l’enregistrement actif.

Vérification de l’état EOF.

Vérification de l’état BOF.

renvoie les métadonnées des messages dans le jeu de résultats, particulièrement utile lorsque le jeu de résultats est ouvert en appelant IAttachment::openCursor() avec le paramètre de format de sortie des métadonnées défini sur NULL (c’est la seule façon d’obtenir le format du message dans ce cas).

Ferme le jeu de résultats, libère l’interface en cas de succès.

Ferme la connexion au gestionnaire de services et, en cas de succès, libère l’interface. Remplace isc_service_detach().

Envoie et demande des informations vers/depuis le service, et receiveItems peut être utilisé à la fois pour exécuter des services et pour recevoir diverses informations sur le serveur. Remplace isc_service_query().

Exécute l’utilitaire dans Service Manager. Remplace isc_service_start().

Remplace isc_dsql_sql_info().

Le type d’opérateur ne se trouve actuellement que dans les sources Firebird dans dsql/dsql.h.

Renvoie le plan d’exécution de l’opérateur.

Renvoie le nombre d’enregistrements affectés par l’opérateur.

Renvoie les métadonnées des paramètres.

Renvoie les métadonnées des valeurs de sortie.

Exécute toutes les instructions SQL, à l’exception de celles qui renvoient plusieurs lignes de données. Analogique partiel de isc_dsql_execute2() — l’entrée et la sortie de XSLQDA ont été remplacées par des messages d’entrée et de sortie avec les tampons correspondants.

Exécute une instruction SQL qui renvoie potentiellement plusieurs lignes de données. Renvoie l’interface IResultSet qui doit être utilisée pour récupérer ces données. Le format de la sortie est déterminé par le paramètre outMetadata, si NULL est spécifié, le format par défaut sera utilisé.

Remplace isc_dsql_set_cursor_name().

Détruit l’opérateur, libère l’interface en cas de succès.

Renvoie des indicateurs décrivant comment cette instruction doit être exécutée, un remplacement simplifié de la méthode getType().

Renvoie le délai d’expiration de la requête SQL en millisecondes.

Définit le délai d’exécution de la requête SQL en millisecondes.

Crée une interface IBatch pour une instruction SQL avec des paramètres d’entrée, ce qui permet à cette instruction d’être exécutée avec plusieurs ensembles de paramètres. Le format des données d’entrée est déterminé par le paramètre inMetadata, le laissant NULL, le package utilise le format par défaut de cette interface. Un bloc de paramètres peut être passé à la fonction createBatch(), qui permet de configurer le comportement du paquet.

Nettoie l’interface et la réinitialise à son état d’origine.

Renvoie l’état actuel de l’interface, les flags retournés peuvent être combinés avec OR.

Définit le contenu du vecteur d’erreur avec la longueur explicitement spécifiée dans l’appel.

Définit le contenu du vecteur d’alerte avec la longueur explicitement spécifiée dans l’appel.

définit le contenu du vecteur d’erreur, la longueur est déterminée par le contexte de valeur.

définit le contenu du vecteur d’alerte, la longueur est déterminée par le contexte de valeur.

Renvoie un vecteur d’erreur.

Renvoie un vecteur d’alerte.

Crée un clone de l’interface courante.

Renvoie le nombre total de messages traités.

Renvoie le résultat d’un message avec le numéro pos. Pour toute erreur avec le message, il s’agit d’une constante EXECUTE_FAILED, la valeur de retour en cas de succès dépend de la présence du paramètre RECORD_COUNTS lors de la création du paquet.Lorsqu’elle est présente et qu’elle a une valeur différente de zéro, le nombre d’enregistrements insérés, mis à jour ou supprimés lors du traitement d’un message particulier est renvoyé, sinon la constante SUCCESS_NO_INFO est renvoyée.

Recherche le message suivant (commençant par pos) à l’origine de l’erreur.En l’absence d’un tel message, la constante NO_MORE_ERRORS est renvoyée. Le nombre de vecteurs d’état renvoyés dans cette interface est limité par la valeur du paramètre DETAILED_ERRORS lors de la création du package.

Renvoie des informations détaillées (vecteur d’état complet) sur l’erreur qui s’est produite lors du traitement du message pos.Pour faire la distinction entre les erreurs (dans IBatch::execute() ou dans IBatchCompletionState::getStatus()), cet état est renvoyé dans un paramètre to séparé, par opposition aux erreurs dans cet appel, qui sont placées dans le paramètre status.

La méthode est appelée lorsque le minuteur sonne (ou lorsque le serveur s’arrête).

Lancez ITimer après le signal (en microsecondes, 10^-6 secondes). La minuterie ne se réveillera qu’une seule fois après cet appel.

stop ITimer. N’arrêtez pas un chronomètre qui n’est pas en cours d’exécution, ce qui évitera les problèmes de conflit entre le signal stop() et le signal du minuteur.

Remplace isc_transaction_info().

Remplace isc_prepare_transaction2().

Remplace isc_commit_transaction().

Remplace isc_commit_retaining().

Remplace isc_rollback_transaction().

Remplace isc_rollback_retaining().

Remplace fb_disconnect_transaction().

connecte la transaction en cours et la transaction passée en paramètre en une seule transaction distribuée (à l’aide de Dtc). En cas de réussite, la transaction en cours et la transaction passée en paramètre sont libérées et ne doivent plus être utilisées.

Cette méthode est utilisée pour soutenir le coordinateur des transactions distribuées.

Cette méthode est utilisée pour prendre en charge le coordinateur des transactions distribuées.

Appelé par le moteur Firebird pour chaque ligne de la version multiligne du rapport. Permet d’imprimer ces lignes une par une, de les placer dans le champ de message de n’importe quelle interface graphique, etc.

Construit un rapport de version pour firebird. Cela peut être vu dans ISQL lorsqu’il est appelé avec l’option -Z.

Chargez un BLOB à partir d’un fichier.

Enregistre le BLOB dans un fichier.

Obtient des statistiques pour la connexion.

Exécute l’instruction CREATE DATABASE…​ - l’astuce ISC avec le handle d’opérateur NULL ne fonctionne pas avec les interfaces.

Remplace isc_decode_sql_date().

Remplace isc_decode_sql_time().

Remplace isc_encode_sql_date().

Remplace isc_encode_sql_time().

Remplace fb_interpret(). La taille de la mémoire tampon passée à cette méthode ne doit pas être inférieure à 50 octets.

Renvoie un entier contenant la version majeure dans l’octet 0 et la version mineure dans l’octet 1.

Renvoie le lien d’interface :#fbapi-interfaces-ixpbbuilder[IXpbBuilder].Les kind valides sont listés dans IXpbBuilder.

Définit les décalages autorisés sur IMessageMetadata. Effectue des appels de rappel à IOffsetsCallback pour chaque champ/paramètre.

Renvoie l’interface IDecFloat16.

Renvoie l’interface IDecFloat34.

Décode l’heure avec le fuseau horaire.

Décode un horodatage (date-heure) avec un fuseau horaire.

Encode l’heure avec le fuseau horaire.

Encode un horodatage (date-heure) avec un fuseau horaire.

Renvoie l’interface IInt128.

Décode l`heure dans un format de fuseau horaire étendu.

Décode un horodatage (date-heure) dans un format de fuseau horaire étendu.

Réinitialise le constructeur à un état vide.

Supprime le clumplet en cours.

Insère un agrégat avec une valeur qui représente un entier dans le format réseau.

Insère un agrégat avec une valeur qui représente un entier 64 bits au format réseau.

Insère un clumpet avec une valeur qui contient les octets passés.

Insère un clumpet sans valeur.

Vérifie s`il y a un clumpet actuelle.

Passe au clumpet suivant.

Se positionne sur le premier clumpet

Trouve le premier clumpet avec cette balise.

Recherche le clumpet suivant avec la balise spécifiée.

Renvoie la balise du clumpet courant.

Renvoie la longueur de la valeur actuel du clumpet.

Renvoie la valeur du clumpet courant sous forme d’un entier.

Renvoie la valeur du clumpet courant sous forme d’un 64 bits.

Renvoie la valeur de l’agrégat courant sous la forme d’un pointeur vers une chaîne de terminaisons null (le pointeur est valide jusqu’au prochain appel de cette méthode).

Renvoie la valeur du clumpet courant sous la forme d’un pointeur vers unsigned char.

Renvoie la longueur du bloc de paramètres.

Renvoie un pointeur vers le bloc de paramètres.

Stocke une clé symétrique du type spécifié.

Stocke une paire de clés asymétriques du type spécifié.

Renvoie la clé de chiffrement.

renvoie la clé à déchiffrer (dans le cas d’une clé symétrique, le résultat est le même que getEncryptKey()).

Renvoie une liste de clés valides séparées par des espaces/tabulations/virgules.

Le plugin doit utiliser la clé qui lui est passée par cet appel.

Chiffre le paquet qui doit être envoyé sur le réseau.

Déchiffre le paquet reçu du réseau.

Efface le bloc cible.

Ajoute un nom d’utilisateur.

Définit le type de connexion à ajouter (utilisateur, rôle, groupe, etc.).

Installe la base de données de sécurité sur laquelle l`authentification a été effectuée.

Remplace isc_blob_info().

remplace isc_get_segment(). En revanche, les erreurs isc_segstr_eof et isc_segment (qui ne sont pas réellement des erreurs) ne sont jamais renvoyées, mais les codes de sortie IStatus::RESULT_NO_DATA et IStatus::RESULT_SEGMENT sont renvoyés, renvoyant généralement IStatus::RESULT_OK.

remplace isc_put_segment().

remplace isc_cancel_blob(). En cas de succès, l’interface est libérée.

remplace isc_close_blob(). En cas de succès, l’interface est libérée.

remplace isc_seek_blob().

Renvoie le nom d’utilisateur transmis par le client.

Renvoie les données d’authentification transmises par le client.

transmet les données d’authentification au client.

Crée une nouvelle clé de chiffrement et l’ajoute à la liste des plugins de chiffrement du trafic réseau disponibles.

Effectue une seule étape d’authentification. L’échange de données avec le client s’effectue à l’aide de l’interface sBlock. Lorsqu’un élément d’authentification est créé, il doit être ajouté au bloc d’authentification à l’aide de writerInterface. Les valeurs de retour possibles sont définies dans l’interface IAuth.

Définit l’interface de rappel de chiffrement de base de données qui sera utilisée pour les connexions ultérieures à la base de données etServices.

Renvoie le nom d’utilisateur s’il est présent dans le DPB.

Renvoie le mot de passe s`il est présent dans le DPB.

Renvoie les données d`authentification envoyées par le serveur.

Transmet les données d’authentification au serveur.

Crée une nouvelle clé de chiffrement et l’ajoute à la liste des plugins de chiffrement du trafic réseau disponibles

Effectue une seule étape d’authentification. L’échange de données avec le serveur s’effectue à l’aide de l’interface cBlock. Les valeurs de retour possibles sont définies dans l’interface IAuth.AUTH_SUCCESS est traité par le côté client comme AUTH_MORE_DATA (c’est-à-dire que le client envoie les données générées au serveur et attend une réponse de celui-ci).

Renvoie une valeur différente de zéro si une valeur a été saisie (affectée) au champ.

Renvoie une valeur différente de zéro si la valeur du champ a été affectée à NULL.

Définit l’indicateur saisi sur 0 ou une valeur différente de zéro pour le champ. Il n’y a aucun moyen d’assigner NULL à un champ car ce n’est jamais obligatoire.

renvoie la valeur du champ sous la forme d’une chaîne C (borne \0).

Attribue une valeur au champ. Définit l’indicateur entré sur true.

Renvoie la valeur du champ.

Attribue une valeur au champ. Définit l’indicateur entré sur true.

Opcode (voir la liste ci-dessous)

Nom d’utilisateur

mot de passe.

Ceci et les 2 composants suivants du nom d’utilisateur complet.

Commentaire (à partir de l’instruction SQL COMMENT ON USER IS…​).

sous la forme tag1=val1, tag2=val2, …​, tagN=valN. Val peut être vide, ce qui signifie que la balise sera supprimée.

Modifie le paramètre ACTIVE/INACTIVE pour l’utilisateur.

Définit/supprime les droits d’administrateur de l’utilisateur.

Spécifie que tous les champs ne sont pas saisis ou spécifiés.

fonction de rappel. L’implémentation peut faire ce qu’elle veut avec les données reçues. Par exemple, il peut placer les données du paramètre utilisateur dans le flux de sortie du service, ou il peut les placer dans des tables spéciales SEC$ du groupe.

Renvoie le nom d’utilisateur de la connexion actuelle.

Renvoie le rôle actif de la connexion actuelle.

Renvoie le journal réseau de la connexion en cours. Non utilisé actuellement par les plugins.

Renvoie l’adresse distante de la connexion actuelle. Non utilisé actuellement par les plugins.

Renvoie le bloc d’authentification de la connexion en cours. S’il n’est pas NULL, réécrit le nom d’utilisateur.

Recherche un enregistrement par son nom.

Recherche un enregistrement par son nom et sa valeur

Recherche un enregistrement par son nom et sa position. Si le fichier de configuration contient les lignes suivantes :

l’appel de findPos(status, « Db », 2) renverra une entrée avec la valeur DBB.

exécute le plugin, si nécessaire, il se connecte à la base de données de sécurité pour gérer les utilisateurs (qu’il faille ou non utiliser cette solution dépend du plugin) en utilisant les informations d’identification de logonInfo.

Exécute la commande fournie par la méthode operation() du paramètre user.Si nécessaire, l’interface de rappel sera utilisée.Le paramètre callback peut être défini sur NULL pour les commandes qui ne nécessitent pas de liste d’utilisateurs.

Prend en compte les modifications apportées par les appels à la méthode execute().

Annule les modifications apportées par les appels à la méthode execute().

Lorsqu’un callback est exécuté, l’information est transmise dans les deux sens. La source de clé reçoit les octets de données dataLength et peut envoyer les octets bufferLength à la mémoire tampon. Renvoie le nombre réel d’octets mis en mémoire tampon.

Invoqué lorsque l’interface n’est plus nécessaire. Permet d’éviter les fuites de mémoire dans les interfaces à état plein.

Invoquée après l’attachement sur le système client. NULL dans attStatus signifie que l’attachement a réussi mais afterAttach() est quand même invoqué pour permettre au plugin d’effectuer le nettoyage nécessaire.

Renvoie le nom complet (y compris le chemin d’accès) du fichier de base de données principal.

est utilisé pour fournir des informations au plugin de chiffrement de base de données sur la clé de chiffrement. Firebird ne transmet jamais directement les clés de ce type de plugin. Au lieu de cela, le tableau IKeyHolderPlugins de la longueur spécifiée est passé au plugin de chiffrement, qui doit recevoir l’interface ICryptKeyCallback de l’un d’entre eux, puis récupérer la clé en l’utilisant. Le paramètre keyName est le nom de la clé qui a été saisie dans l’instruction ALTER DATABASE ENCRYPT …​.

Chiffre les données avant d’écrire un bloc dans un fichier de base de données

Déchiffre les données après avoir lu le bloc à partir du fichier de base de données.

Dans cette méthode, le plugin de cryptage enregistre généralement l’interface d’information pour une utilisation ultérieure.

est utilisé pour passer l’interface ICryptKeyCallback à la connexion (si elle est fournie par l’utilisateur avec l’appel IProvider::setDbCryptCallback()). Cet appel est toujours effectué au moment de la connexion à la base de données, et certains détenteurs de clés peuvent rejeter la connexion si aucune clé satisfaisante n’a pas été fournie.

est destiné à être directement invoqué par l’interface IDbCryptPlugin pour obtenir l’interface de rappel de la clé nommée auprès du détenteur de la clé.Cela vous permet d’utiliser le code Firebird open-source afin de ne jamais toucher aux touches réelles, évitant ainsi la possibilité de vol de clé en modifiant le code Firebird. Après avoir reçu l’interface ICryptKeyCallback, le plugin de chiffrement démarre la communication à l’aide de celle-ci. Le détenteur de la clé peut (par exemple) vérifier la signature numérique du plugin de chiffrement avant de lui envoyer la clé afin d’éviter d’utiliser un plugin de chiffrement modifié qui pourrait voler la clé privée.

informe Firebird si une clé fournie par un autre détenteur de clé sera utilisée ou non. Cela n’a de sens que pour SuperServer : seul SuperServer peut partager des clés de chiffrement de base de données entre les connexions. En renvoyant un FB_TRUE de cette méthode, il force Firebird à s’assurer que ce détenteur de clé particulier (et donc la connexion qui lui est associée) fournit la clé de chiffrement correcte avant de l’autoriser à fonctionner avec la base de données.

Prise en charge du porte-clés. Dans certains cas, la clé doit passer par plusieurs détenteurs de clés avant d’atteindre le plugin de chiffrement de la base de données. Ceci est nécessaire (par exemple) pour prendre en charge EXECUTE STATEMENT dans une base de données chiffrée. Ce n’est qu’un exemple – les chaînes sont également utilisées dans d’autres cas. L’interface de rappel renvoyée par cette méthode peut différer de celle renvoyée par la fonction keyHandle() (voir ci-dessus). En règle générale, il devrait être capable de dupliquer les clés reçues de IKeyHolderPlugin lors de l’appel de la fonction keyCallback().

Renvoie l’emplacement du répertoire correspondant dans l’instance courante de Firebird. Les codes d’annuaire de cet appel sont ci-dessous.

Renvoie une interface permettant d’accéder aux valeurs de configuration par défaut (à partir de firebird.conf).

Renvoie une interface permettant d’accéder à une configuration spécifique à la base de données (prend en compte firebird.conf et la partie correspondante de database.conf).

Renvoie une interface permettant d’accéder à la configuration du plugin nommé.

Renvoie le répertoire dans lequel Firebird est installé.

Renvoie le répertoire racine de l’instance courante, dans le cas d’une instance unique, généralement le même que le répertoire d’installation.

Renvoie le chemin d’accès par défaut (c’est-à-dire à l’exclusion des fichiers de configuration de compte) à la base de données de sécurité, utilisé principalement pour un usage interne, afin de garantir un accès correct à la base de données de sécurité sur un serveur avec plusieurs fournisseurs sans aucune configuration.

Renvoie le nom de la clé.

Renvoie une valeur sous la forme d’une chaîne de caractères.

Traite la valeur comme un entier et la renvoie.

Traite la valeur comme booléenne et la renvoie.

Traite les sous-en-têtes comme un fichier de configuration séparé et renvoie l’interface IConfig correspondante.

Convertit une valeur décimale à virgule flottante en BCD.

Convertit une valeur décimale à virgule flottante en chaîne.

Collecte une valeur décimale à virgule flottante à partir de BCD.

Collecte une valeur décimale à virgule flottante à partir d’une chaîne.

Convertit une valeur décimale à virgule flottante en BCD.

Convertit une valeur décimale à virgule flottante en chaîne.

Collecte une valeur décimale à virgule flottante à partir de BCD.

Collecte une valeur décimale à virgule flottante à partir d’une chaîne.