Funzione SQLWriteFileDSN

  • Articolo

Conformità
Versione introdotta: ODBC 3.0

Riepilogo
SQLWriteFileDSN scrive informazioni in un DSN file.

Sintassi

  
BOOL SQLWriteFileDSN(  
     LPCSTR     lpszFileName,  
     LPCSTR     lpszAppName,  
     LPCSTR     lpszKeyName,  
     LPCSTR     lpszString);

Argomenti

lpszFileName
[Input] Puntatore al nome del DSN file. Un'estensione DSN viene aggiunta a tutti i nomi di file che non dispongono già di un'estensione DSN.

lpszAppName
[Input] Puntatore al nome dell'applicazione. Si tratta di "ODBC" per la sezione ODBC.

lpszKeyName
[Input] Puntatore al nome della chiave da leggere. Vedere "Commenti" per le parole chiave riservate.

lpszString
[Output] Punta alla stringa associata alla chiave da scrivere. La lunghezza massima della stringa a cui punta questo argomento è di 32.767 byte.

Resi

Se ha esito positivo, la funzione restituisce TRUE se ha esito negativo.

Diagnostica

Quando SQLWriteFileDSN restituisce FALSE, è possibile ottenere un valore *pfErrorCode associato chiamando SQLInstallerError. Nella tabella seguente sono elencati i valori *pfErrorCode che possono essere restituiti da SQLInstallerError e spiega ognuno nel contesto di questa funzione.

*pfErrorCode Errore Descrizione
ODBC_ERROR_GENERAL_ERR Errore generale del programma di installazione Si è verificato un errore per il quale non si è verificato un errore specifico del programma di installazione.
ODBC_ERROR_INVALID_PATH Percorso di installazione non valido Il percorso del nome file specificato nell'argomento lpszFileName non è valido.
ODBC_ERROR_INVALID_REQUEST_TYPE Tipo di richiesta non valido L'argomento lpszAppName, lpszKeyName o lpszString è NULL.

Commenti

ODBC riserva il nome della sezione [ODBC] in cui archiviare le informazioni di connessione. Le parole chiave riservate per questa sezione sono identiche a quelle riservate per una stringa di connessione in SQLDriverConnect. Per altre informazioni, vedere Descrizione della funzione SQLDriverConnect .

Le applicazioni possono usare queste parole chiave riservate per scrivere informazioni direttamente in un DSN file. Se un'applicazione vuole creare o modificare la stringa di connessione senza DSN associata a un DSN file, può chiamare SQLWriteFileDSN per una delle parole chiave della stringa di connessione riservata nella sezione [ODBC].

Se l'argomento lpszString è un puntatore Null, la parola chiave a cui punta l'argomento lpszKeyName verrà eliminata dal file dsn. Se gli argomenti lpszString e lpszKeyName sono entrambi puntatori Null, la sezione a cui punta l'argomento lpszAppName verrà eliminata dal file dsn.

Per informazioni su Vedere
Lettura di informazioni da DSN file SQLReadFileDSN