GETDBENGINEINFO
Permette di ricavare le informazioni 'basilari' per comprendere la configurazione del motore di database installato sul Server specificato.
Le informazioni basilari identificate sono se il motore è attivo, la versione ed il numero massimo di utenti previsti dalla licenza acquisita.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| SORGENTE | Intero | ||||
| SERVER | Stringa | ||||
| UTENTE | Stringa | ||||
| PASSWORD | Stringa | ||||
| WINAUT | Intero | ||||
| DATABASE | Stringa | ||||
| ATTIVO | Intero | ||||
| VERSIONE | Stringa | ||||
| CODICEVERSIONE | Stringa | ||||
| NUMEROMAXUTENTI | Intero | ||||
| VERSIONECOMPLETA | Blob | ||||
| ERRORE | Intero |
SORGENTE
Valore numerico che rappresenta il codice della sorgente dati TipoSorgente: costante o variabile numerica intera.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | Btrieve |
1 | Microsoft SQL Server |
2 | PervasiveSQL2000 |
3 | Pervasive/Btrieve SQL |
4 | Oracle |
SERVER
Indica il nome del server di cui devono essere reperite le informazioni.
Se non indicato il nome del server, lo stesso viene determinato in base al tipo di sorgente di dati, e restituito in output.
UTENTE
Restituisce il nome utente da utilizzare per l'autenticazione al database indicato nel parametro DATABASE della specifica.
Viene valorizzata solo nel caso di Sorgente = 1 (MS SQL SERVER)
PASSWORD
Restituisce la password da utilizzare per l'autenticazione al database indicato nel parametro DATABASE della specifica.
Viene valorizzata solo nel caso di Sorgente = 1 (MS SQL SERVER).
WINAUT
Indica se al Database e' richiesta la connessione attraverso l'autenticazione Windows.
Valori ammessi:
| Valore | Descrizione |
|---|---|
| 0 | Autenticazione con utente e Password |
| 1 | Autenticazione Windows |
Viene valorizzata solo nel caso di Sorgente = 1 (MS SQL SERVER)
DATABASE
Restituisce il nome del database a cui accedere per verificare il funzionamento del motore di database.
Viene valorizzata solo nel caso di Sorgente = 1 (MS SQL SERVER)
ATTIVO
Restituisce lo stato del motore di database, se funzionante oppure no.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No, il motore non è attivo |
1 | Sì, il motore è attivo |
VERSIONE
Restituisce la versione del motore di Database letta dalla configurazione del database specificato.
Viene restituita con la sola informazione del codice versione.
Nel caso in cui non sia possibile leggere la versione del database il parametro viene impostato a '-1'.
CODICEVERSIONE
Restituisce la versione del motore di Database letta dalla configurazione del database specificato.
Viene restituita con la sola informazione del codice versione.
Nel caso in cui non sia possibile leggere la versione del database il parametro viene impostato a '-1'.
NUMEROMAXUTENTI
Restituisce il numero massimo di utenti contemporaneamente abilitati all'utilizzo del database.
VERSIONECOMPLETA
Restituisce un dato blob con tutte le informazioni del database.
Esempio: Microsoft SQL Server 2005 - 9.00.5000.00 (Intel X86) Dec 10 2010 10:56:29 Copyright (c) 1988-2005 Microsoft Corporation Express Edition on Windows NT 5.1 (Build 2600: Service Pack 3)
ERRORE
Consente al programma di intercettare e gestire l'errore restituito dalla funzione.
Utilizzare uno dei metodi GetLastError*() della classe BCContextInfo per ottenere le informazioni dell'errore.