Renvoie une clé pour un nom de paramètre donné. ~0 (tous les bits sont égaux à 1) est renvoyé s’il n’y a pas de tel paramètre.

Renvoie la valeur d’un paramètre entier.

Renvoie la valeur d’un paramètre de chaîne

Renvoie la valeur d’un paramètre booléen. Les abréviations standard (1/true/t/yes/y) sont traitées comme vraies, toutes les autres abréviations sont traitées comme fausses.

Renvoie la version de Configuration Manager associée à cette interface.Différentes versions de Configuration Manager peuvent coexister sur le même serveur, par exemple, lorsqu’un ancien moteur de base de données est utilisé sur un serveur moderne. Notez que les clés (voir getKey()) des différentes versions ne correspondent pas et retourneront toujours 0/nullptr/false si elles ne sont pas utilisées correctement.

Convertit une valeur entière de 128 bits en une chaîne prenant en charge la mise à l’échelle.

Assemble une valeur entière de 128 bits à partir d’une chaîne prenant en charge la mise à l’échelle.

Renvoie une instance de l’interface IStatus.

Renvoie une instance de l’interface IProvider implémentée par YValve (l’instance principale du fournisseur).

Renvoie une instance de l’interface IPluginManager.

Renvoie une instance d’une interface ITimerControl.

Renvoie une instance d’une interface IDtc.

Renvoie une instance d’une interface IUtil.

Renvoie une instance d’une interface IConfigManager.

Renvoie le nombre de champs/paramètres dans le message. Dans tous les appels qui contiennent un paramètre index, cette valeur doit être : 0 >= index < getCount().

Renvoie le nom du champ.

Renvoie le nom de la relation (à partir de laquelle le champ a été sélectionné).

Renvoie le nom du propriétaire de la relation.

Renvoie un alias de champ.

Renvoie le type SQL du champ.

Renvoie true si le champ peut être défini sur NULL.

Renvoie un sous-type du champ BLOB (0 pour le binaire, 1 pour le texte, etc.).

Renvoie la longueur maximale du champ.

Renvoie l’échelle du champ numérique.

Renvoie un jeu de caractères pour les champs de caractères et un objet blob de texte.

Renvoie le décalage des données de champ dans la mémoire tampon de message (utilisez-la pour accéder aux données de la mémoire tampon du message).

Renvoie le décalage NULL de l’indicateur pour le champ dans le tampon de message.

Renvoie le lien d’interface :#fbapi-interfaces-imetadatabuilder[IMetadataBuilder] initialisé avec les métadonnées de ce message.

Renvoie la longueur de la mémoire tampon du message (utilisez-la pour allouer de la mémoire pour le tampon).

Renvoie l’alignement en octets.

Renvoie la taille de la structure de métadonnées après l’alignement.

Définit le type SQL du champ.

Définit le sous-type BLOB du champ.

Définit la longueur maximale du champ de caractère.

Définit le jeu de caractères pour le champ de caractère et l’objet blob de texte.

Définit l’échelle des champs numériques.

Tronque le message afin qu’il ne contienne pas plus qu’un nombre de champs.

Réorganise les champs d’un message : déplace un champ nommé nom vers une position spécifiée.

Supprime le champ.

Ajoute un champ.

Renvoie le lien d’interface :#fbapi-interfaces-imessagemetadata[IMessageMetadata] construit par le compilateur.

Définit le nom du champ/de la colonne.

Définit le nom de la relation pour le champ.

Définit le nom du propriétaire.

Définit l’alias du champ.

Définis le décalage qui doit être assigné pour le champ/paramètre indexé. Doit être implémenté par l’utilisateur lors de l’implémentation de l’interface MessageMetadata et de l’utilisation de IUtil::setOffsets().

Ajoute le nombre de messages de inBuffer au lot. La taille totale des messages pouvant être ajoutés à un lot est limitée par le paramètre « TAG_BUFFER_BYTES_SIZE » lors de la création du lot.

Ajoute un octet length de inBuffer au paquet, le BLOB est situé à blobId.Si le blob doit être créé avec des paramètres autres que la valeur par défaut, BPB peut être passé (le format est le même que celui utilisé dans Attachment::createBlob).La taille totale des objets blob intégrés qui peuvent être ajoutés à un package (y compris les BPB facultatifs, les en-têtes BLOB, la taille du segment avec alignement) est limitée par le paramètre TAG_BUFFER_BYTES_SIZE lors de la création du package (affecte toutes les méthodes orientées BLOB à l’exception de registerBlob()).

Étend le dernier BLOB ajouté en ajoutant des octets de la longueur length prise à partir de l’adresse inBuffer.

Ajoute des données BLOB (il peut s’agir de plusieurs objets ou d’une partie d’un seul BLOB) à un lot. L’en-tête de chaque BLOB du flux est aligné sur la limite getBlobAlignment() et contient 3 champs : le premier est le BLOB de 8 octets (au format ISC_QUAD), le second est la longueur de 4 octets du BLOB et le troisième est la longueur de 4 octets du BPB. L’en-tête d’objet blob ne doit pas franchir les limites de la mémoire tampon dans cet appel de fonction. Les données BPB sont placées immédiatement après l’en-tête, suivies des données d’objet blob.La longueur de l’objet blob inclut le BPB (le cas échéant). Toutes les données peuvent être distribuées sur plusieurs appels à addBlobStream(). Les données d’objets blob, à leur tour, peuvent être structurées dans le cas d’un objet blob partitionné, voir le chapitre Modification des données par lots.

Permet d’utiliser des BLOB ajoutés à l’aide de l’interface standard IBlob dans le package. Cette fonction contient 2 paramètres ISC_QUAD*, il est important de ne pas les confondre – le deuxième paramètre (existingBlob) est un pointeur vers le BLOB déjà ajouté en dehors de la portée du package, le troisième (blobId) pointe vers le BLOB qui sera placé dans le message de ce package`.

Exécute le paquet avec les paramètres qui lui sont transmis dans les messages. Si le paramètre MULTIERROR n’est pas défini dans le bloc de paramètres lors de la création d’un lot, l’exécution du lot sera arrêtée après la première erreur, un nombre illimité d’erreurs peut se produire en mode MULTIERROR, après une erreur l’exécution se poursuit avec le message suivant. Cette fonction renvoie l’interface IBatchCompletionState, qui contient toutes les informations demandées sur les résultats de l’exécution du lot.

Efface les tampons de message et les objets BLOB, en rétablissant le paquet dans l’état dans lequel il se trouvait lors de sa création.Notez que l’interface de comptage de références IBatch ne contient pas de fonction spéciale pour la fermer, utilisez release() pour le faire.

Renvoie l’alignement requis pour les données mises en mémoire tampon par la fonction addBlobStream().

Renvoie le format des métadonnées utilisées dans les messages batch.

Spécifie le BPB qui sera utilisé pour tous les objets blob qui n’ont pas de BPB par défaut.Doit être appelé avant qu’un message ou un objet blob ne soit ajouté à un lot.

Demande des informations sur le package.

Renvoie le nom recommandé du fichier dans lequel la configuration du plugin est censée être enregistrée.

Configuration du plugin chargée selon les règles standard.

Retourne la configuration principale de Firebird, en tenant compte des paramètres de la base de données avec laquelle la nouvelle instance de plugin fonctionnera.

Utilisé par le plugin pour configurer le délai recommandé pendant lequel le module de plugin ne sera pas déchargé par le gestionnaire de plugin après que la dernière instance du plugin soit libérée de ce module.

Crée une nouvelle instance du plugin avec la configuration recommandée transmise.

Enregistre un constructeur de plugins nommée de ce type.

Enregistre le module de plugin.

Annule l’enregistrement du module plugin.

Renvoie une interface IPluginSet qui permet d’accéder à une liste de plugins de ce type. Les noms des plugins inclus sont tirés de la namesList, s’ils sont absents (NULL), alors ils proviennent des paramètres de configuration de ce type donné pluginType. Si le paramètre firebirdConf est spécifié, il est utilisé à toutes fins de configuration (y compris l’obtention d’une liste de plugins et la navigation vers la méthode PluginFactory::createPlugin()), s’il est manquant (NULL), alors le paramètre par défaut (de firebird.conf) est utilisé.

Renvoie l’interface IConfig pour le nom de fichier de configuration spécifié.Peut être utilisé par les plugins pour accéder aux fichiers de configuration avec un format standard, mais pas avec un nom par défaut.

Libérez le plugin. Devrait être utilisé pour les plugins au lieu du simple release() en raison de la nécessité d’effectuer des actions supplémentaires avec le propriétaire du plugin avant de le publier.

Appelé par le gestionnaire de plugin avant que le module de plugin ne soit déchargé normalement.

Renvoie le nom du plugin courant dans l’ensemble.

Retourne le nom du module du plugin courant dans l’ensemble (dans le cas le plus simple, le même que le nom du plugin).

renvoie une instance du plugin courant, l’interface retournée doit être convertie en l’interface du plugin principal du type demandé dans la méthode IPluginManager::getPlugins(). Renvoie NULL s’il n’y a plus de plugins dans l’ensemble. Le nombre de liens du plugin renvoyé par cette fonction est incrémenté lorsqu’il est renvoyé — n’oubliez pas d’utiliser la méthode releasePlugin() de l’interface IPluginManager pour libérer les plugins retournés par cette méthode.

Définit un bouton bascule pour passer au plugin suivant dans la liste.

Réinitialise l’interface : la fait fonctionner avec la liste des plugins fournie par le paramètre list. Le type de plugins reste le même.

Crée une connexion à une base de données existante. Remplace isc_attach_database().

Crée une nouvelle base de données et renvoie l’interface pour s’y connecter. Remplace isc_create_database().

Remplace isc_service_attach().

Remplace fb_shutdown().

Définit l’interface de retour de chiffrement de base de données qui sera utilisée pour les connexions ultérieures à la base de données et aux services.

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.