int sqlite3_config(int, ...);
sqlite3_config() 介面用於對 SQLite 進行全域設定變更,以便根據應用程式的特定需求調整 SQLite。大多數應用程式建議使用預設設定,因此通常不需要使用此常式。它提供支援具有特殊需求的少數應用程式。
sqlite3_config() 介面並非執行緒安全。應用程式必須確保在 sqlite3_config() 執行時,其他執行緒不會呼叫其他 SQLite 介面。
sqlite3_config() 的第一個參數是一個整數設定選項,用於決定要設定 SQLite 的哪個屬性。後續的參數會根據第一個參數中的設定選項而有所不同。
對於大多數設定選項,sqlite3_config() 介面只能在使用 sqlite3_initialize() 初始化函式庫之前或使用 sqlite3_shutdown() 關閉之後呼叫。可以在任何時候呼叫的例外設定選項稱為「隨時設定選項」。如果在 sqlite3_initialize() 之後和 sqlite3_shutdown() 之前呼叫 sqlite3_config(),且第一個參數不是隨時設定選項,則 sqlite3_config() 呼叫將返回 SQLITE_MISUSE。但請注意,sqlite3_config() 可以作為應用程式定義的 sqlite3_os_init() 的一部分來呼叫。
設定設定選項後,sqlite3_config() 會返回 SQLITE_OK。如果選項未知或 SQLite 無法設定選項,則此常式會返回非零的錯誤碼。