Funzione SQLWritePrivateProfileString

Conformità
Versione introdotta: ODBC 2.0

Riepilogo
SQLWritePrivateProfileString scrive un nome di valore e i dati nella sottochiave Odbc.ini delle informazioni di sistema.

Sintassi

  
BOOL SQLWritePrivateProfileString(  
     LPCSTR     lpszSection,  
     LPCSTR     lpszEntry,  
     LPCSTR     lpszString,  
     LPCSTR     lpszFilename);  

Argomenti

lpszSection
[Input] Punta a una stringa con terminazione Null contenente il nome della sezione in cui verrà copiata la stringa. Se la sezione non esiste, viene creata. Il nome della sezione è indipendente dal caso; la stringa può essere qualsiasi combinazione di lettere maiuscole e minuscole.

lpszEntry
[Input] Punta a una stringa con terminazione Null contenente il nome della chiave da associare a una stringa. Se la chiave non esiste nella sezione specificata, viene creata. Se questo argomento è NULL, l'intera sezione, incluse tutte le voci all'interno della sezione, viene eliminata.

lpszString
[Input] Punta a una stringa con terminazione Null da scrivere nel file. Se questo argomento è NULL, la chiave a cui punta l'argomento lpszEntry viene eliminata.

lpszFilename
[Output] Punta a una stringa con terminazione Null che denomina il file di inizializzazione.

Valori restituiti

La funzione restituisce TRUE se ha esito positivo, FAL edizione Standard se ha esito negativo.

Diagnostica

Quando SQLWritePrivateProfileString restituisce FAL edizione Standard, è 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_REQUEST_FAILED	Richiesta non riuscita	Impossibile scrivere le informazioni di sistema richieste.
ODBC_ERROR_OUT_OF_MEM	Memoria insufficiente	Il programma di installazione non è riuscito a eseguire la funzione a causa di una mancanza di memoria.

Commenti

SQLWritePrivateProfileString viene fornito come modo semplice per convertire i driver e le DLL di installazione dei driver da Microsoft Windows a Microsoft Windows NT/Windows 2000. Le chiamate a WritePrivateProfileString che scrivono una stringa di profilo nel file Odbc.ini devono essere sostituite con le chiamate a SQLWritePrivateProfileString. SQLWritePrivateProfileString chiama le funzioni nell'API Win32 per aggiungere il nome e i dati di valore specificati alla sottochiave Odbc.ini delle informazioni di sistema.

Una modalità di configurazione indica dove la voce Odbc.ini che elenca i valori DSN si trova nelle informazioni di sistema. Se il DSN è un DSN utente (la variabile di stato è U edizione Standard RDSN_ONLY), la funzione scrive nella voce Odbc.ini in HKEY_CURRENT_U edizione Standard R. Se il DSN è un DSN di sistema (SYSTEMDSN_ONLY), la funzione scrive nella voce Odbc.ini in HKEY_LOCAL_MACHINE. Se la variabile di stato è BOTHDSN, HKEY_CURRENT_U edizione Standard R viene tentata e, in caso di errore, viene usata HKEY_LOCAL_MACHINE.

Funzioni correlate

Per informazioni su	Vedere
Recupero di un valore dalle informazioni di sistema	SQLGetPrivateProfileString