：TaoToken统一Key通道下的连接串与记录集实操)
1. VC++6.0 里 ADO 连接 SQL Server 到底卡在哪：从 Connection 到 Recordset 的完整链路
如果你正在用 VC++6.0 写 MFC 程序，需要从 SQL Server 里读数据，大概率绕不开 ADO。ADO 全称 ActiveX Data Objects，是微软早年提供的一套数据库访问组件，它把底层 OLE DB 的复杂度包了一层，让你用几个 COM 接口就能完成连接、查询、遍历字段。适合谁？适合还在维护老 MFC 项目、做工业上位机、教学演示，或者单纯想搞懂 VC6 时代数据库编程的人。
但初学者最容易卡住的地方，不是语法，而是三件事：第一，Connection 对象的连接串到底怎么写，Provider 选哪个、Server 写 IP 还是主机名、认证用 SQL 还是 Windows；第二，Recordset 打开后游标类型和锁定类型怎么选，选错了要么报错要么字段读不出来；第三，怎么确认连接真的成功了、游标真的在第一条记录上，而不是靠猜。
我试过在 VC6 里直接抄网上的连接串，结果Open返回失败，错误码还看不出原因。后来发现是 Provider 版本和认证方式不匹配。这篇就按“能跑通第一个查询”的目标，把连接串模板、TaoToken 统一 Key 通道的 endpoint 配置、以及用断点和输出窗口验证状态的具体动作讲清楚。你跟着做，至少能拿到一个能返回数据的 Recordset。
先明确一个概念：ADO 是 COM 组件，VC6 里用它需要引入类型库。通常两种方式，一种是用#import指令，一种是在 stdafx.h 里加#import "C:\Program Files\Common Files\System\ado\msado15.dll" no_namespace rename("EOF","adoEOF")。注意EOF要重命名，因为 MFC 里也有 EOF 宏，不重命名会冲突。这一步不做，后面编译一堆错。
连接串的核心是 Provider。连 SQL Server 一般用SQLOLEDB或MSOLEDBSQL。老项目里SQLOLEDB兼容性最好，VC6 环境下推荐先用它。连接串里要写清楚 Server、Database、UID、PWD，或者用Trusted_Connection=yes走 Windows 认证。如果你是通过统一 Key 通道访问远端数据库服务，那 Server 和端口就换成通道提供的 endpoint，认证信息换成通道分配的 Key。下面会给出具体模板。
Recordset 打开时，Open方法的参数顺序是：Source（SQL 语句或表名）、ActiveConnection（Connection 对象或连接串）、CursorType、LockType、Options。CursorType 常用adOpenStatic或adOpenForwardOnly，LockType 常用adLockReadOnly。只读查询用adOpenStatic + adLockReadOnly最稳，能前后移动游标，也支持RecordCount。如果你只需要单向遍历，adOpenForwardOnly性能更好，但RecordCount可能返回 -1。
字段读取用Fields->GetItem("列名")->Value，或者用序号Fields->Item[0]->Value。Value 是 VARIANT 类型，VC6 里要转成_variant_t或CString。转换时注意 NULL 值，直接转可能抛异常，要先判断vt == VT_NULL。
验证连接状态，最直接的办法是在Open之后检查返回值，HRESULT 为 S_OK 说明成功。更直观的是在 VC6 的 Output 窗口用TRACE打印连接状态和记录数。断点打在Open下一行，看m_pConn->State是否为adStateOpen。Recordset 的游标位置用AbsolutePosition看，第一条是 1，BOF和EOF布尔值也能判断是否为空。
这一节先把整体链路和关键概念铺开，下一节讲 TaoToken 统一 Key 通道的前置准备，包括 endpoint 和 Key 怎么拿、怎么配到连接串里。
2. TaoToken 统一 Key 通道前置准备：endpoint、API Key 与模型 ID 三件套怎么配
在 VC6 里连数据库，传统做法是把 Server 地址、账号密码硬编码在连接串里。问题是账号密码散落在代码里不好管，换环境要改代码重新编译。用 TaoToken 统一 Key 通道的思路是：把认证收敛到一个 Key 上，连接串里的 Server 指向通道 endpoint，认证信息用通道分配的 Key。这样换数据库或换环境，只改 endpoint 和 Key，代码结构不动。
先说要准备什么。你需要三样东西：Base URL（也就是 endpoint）、API Key、以及你要访问的目标标识（类似 Model ID 的角色，在数据库场景里就是目标库或服务的标识）。这三件套在 TaoToken 的 console 里都能拿到。打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，进 console 页面，在 API Keys 菜单里创建一个 Key。创建时给它起个名字，比如vc6-ado-test，方便后面区分。
Key 创建后只显示一次，复制下来存好。如果你用的是 Coding Plan 或模型对话场景，Key 是通用的，但数据库通道的 endpoint 可能不同。具体以 console 里显示的接入信息为准。API 的基础地址是 https://taotoken.net/api ，注意这个地址不带 UTM 参数，直接用于代码里的 Base URL。如果你在浏览器里访问，可以带上 UTM 方便归因，但代码里写干净的 API 地址。
endpoint 的拼接方式通常是https://taotoken.net/api加上具体路径。比如模型对话是/v1/chat/completions，coding-plan 相关是/coding-plan，console 是/console，api-keys 管理是/api-keys，ClaudeCodeAnthropic 相关是/claudecode-anthropic。数据库通道的路径以 console 里“接入文档”页面显示的为准。接入文档地址是 https://taotoken.net/doc ，里面有各场景的 endpoint 示例。
拿到三件套后，在 VC6 里怎么用？传统 ADO 连接串是Provider=SQLOLEDB;Server=...;Database=...;UID=...;PWD=...。走统一 Key 通道时，Server 换成通道的 host，端口换成通道端口，UID 和 PWD 换成 Key 相关的凭证。有些通道支持把 Key 直接放在连接串的Password字段，有些需要先换 token。具体看接入文档。
这里给一个通用的配置思路，不针对特定数据库版本：
; TaoToken 统一 Key 通道配置示例（放在项目配置或环境变量里） TAOTOKEN_BASE_URL=https://taotoken.net/api TAOTOKEN_API_KEY=sk-你的Key TAOTOKEN_TARGET=your-database-target然后在 VC6 代码里读取这些配置，拼成连接串。不要硬编码 Key，至少放在单独的配置文件或注册表里。VC6 读 ini 可以用GetPrivateProfileString，读环境变量用getenv。
如果你用的是 Cline MCP 或 CC Switch 这类工具，配置格式可能是 JSON 或 TOML。比如 Cline MCP 的配置片段：
{ "mcpServers": { "taotoken-db": { "command": "your-mcp-server", "env": { "TAOTOKEN_BASE_URL": "https://taotoken.net/api", "TAOTOKEN_API_KEY": "sk-你的Key", "TAOTOKEN_TARGET": "your-database-target" } } } }Codex 的 auth.json 类似：
{ "base_url": "https://taotoken.net/api", "api_key": "sk-你的Key", "model": "your-target-id" }注意，VC6 本身不直接读这些 JSON，但你可以用同样的字段名组织自己的配置。关键是 Base URL、Key、目标标识三件套齐全，缺一个都连不上。
前置准备做完后，下一节给可复制的连接串模板和 Recordset 打开代码。如果你还没创建 Key，先去 console 的 API Keys 页面建一个，再回来看代码。
3. 可复制配置：VC6 里 ADO 连接串模板与 Recordset 打开代码
这一节直接给能复制进项目的代码。先确认你的 VC6 工程已经引入了 ADO 类型库。在 stdafx.h 里加：
#import "C:\Program Files\Common Files\System\ado\msado15.dll" no_namespace rename("EOF", "adoEOF")如果路径不对，找到你机器上 msado15.dll 的实际位置。编译前记得初始化 COM：
::CoInitialize(NULL);程序退出时::CoUninitialize();。
连接串模板分两种。第一种是直连 SQL Server：
CString strConn; strConn.Format( _T("Provider=SQLOLEDB;Server=%s,%d;Database=%s;UID=%s;PWD=%s;"), _T("192.168.1.100"), 1433, _T("TestDB"), _T("sa"), _T("yourpassword"));第二种是走 TaoToken 统一 Key 通道，Server 换成通道 endpoint 的 host 和端口，认证用 Key：
CString strConn; strConn.Format( _T("Provider=SQLOLEDB;Server=%s,%d;Database=%s;UID=%s;PWD=%s;"), _T("taotoken.net"), 1433, _T("your-database-target"), _T("taotoken"), _T("sk-你的Key"));实际 host 和端口以接入文档为准。有些通道用 HTTP 协议，那 ADO 的 Provider 可能要换成MSDASQL或自定义 Provider，具体看文档。如果文档说用 ODBC 方式，连接串改成：
DSN=taotoken-db;UID=taotoken;PWD=sk-你的Key;然后在 ODBC 数据源里配 DSN 指向通道。VC6 里用Provider=MSDASQL加 DSN。
连接对象和记录集的完整代码：
_ConnectionPtr m_pConn; _RecordsetPtr m_pRs; try { m_pConn.CreateInstance(__uuidof(Connection)); HRESULT hr = m_pConn->Open(_bstr_t(strConn), "", "", adConnectUnspecified); if (FAILED(hr)) { TRACE(_T("连接失败, hr=0x%08X\n"), hr); return; } TRACE(_T("连接成功, State=%d\n"), m_pConn->State); m_pRs.CreateInstance(__uuidof(Recordset)); m_pRs->Open( _bstr_t("SELECT TOP 10 * FROM YourTable"), m_pConn.GetInterfacePtr(), adOpenStatic, adLockReadOnly, adCmdText); TRACE(_T("记录数=%ld, BOF=%d, EOF=%d\n"), m_pRs->RecordCount, m_pRs->BOF, m_pRs->EOF); while (!m_pRs->adoEOF) { _variant_t vtVal = m_pRs->Fields->GetItem("YourColumn")->Value; if (vtVal.vt != VT_NULL) { CString strVal = (LPCTSTR)_bstr_t(vtVal); TRACE(_T("值=%s\n"), strVal); } m_pRs->MoveNext(); } m_pRs->Close(); m_pConn->Close(); } catch (_com_error &e) { TRACE(_T("COM 错误: %s, 描述: %s\n"), (LPCTSTR)e.ErrorMessage(), (LPCTSTR)e.Description()); }注意adOpenStatic和adLockReadOnly是枚举值，需要包含 ADO 的类型库后才有定义。如果编译报未定义，手动加：
#define adOpenStatic 3 #define adLockReadOnly 1 #define adCmdText 1或者用_variant_t((long)3)这种写法。RecordCount在adOpenStatic下有效，adOpenForwardOnly下可能返回 -1。
字段读取时，Fields->GetItem的参数可以是列名或序号。列名区分大小写取决于数据库设置，不确定就用序号。_variant_t转CString时，如果值是数字类型，_bstr_t转换可能失败，要先判断vt。安全做法：
CString VariantToCString(const _variant_t& vt) { CString str; switch (vt.vt) { case VT_NULL: case VT_EMPTY: str = _T(""); break; case VT_BSTR: str = (LPCTSTR)_bstr_t(vt); break; case VT_I2: str.Format(_T("%d"), vt.iVal); break; case VT_I4: str.Format(_T("%ld"), vt.lVal); break; case VT_R8: str.Format(_T("%f"), vt.dblVal); break; default: str = (LPCTSTR)_bstr_t(vt); break; } return str; }这段代码可以直接放进你的工具类。连接串里的adConnectUnspecified是 -1，表示异步关闭，一般用这个就行。
配置部分就这些。下一节讲怎么用断点和 Output 窗口验证连接状态和游标位置，确保你真的连上了、真的读到数据了。
4. 验证请求与成功结果：用断点、TRACE 输出和游标位置确认跑通
代码写完了不代表跑通了。VC6 的调试手段有限，但断点加 Output 窗口足够验证。这一节给具体动作。
第一步，在m_pConn->Open这一行按 F9 下断点。F5 启动调试。程序停在这里时，把鼠标移到strConn上，看连接串内容对不对。特别检查 Server、Database、UID、PWD 四个字段。如果 Key 里有特殊字符，确认没有被转义。
第二步，按 F10 单步执行过Open。看hr的值。如果FAILED(hr)为真，Output 窗口会打印连接失败, hr=0x...。常见 hr 值：0x80004005一般是认证失败或 Server 不可达；0x80040E4D是登录失败；0x80040E21是连接串格式错误。对照这些值排查。
第三步，连接成功后，看m_pConn->State。adStateOpen的值是 1。Output 窗口会打印连接成功, State=1。如果 State 是 0，说明连接被关闭了，检查是不是Open之后立刻Close了。
第四步，在m_pRs->Open之后下断点，看RecordCount、BOF、EOF。如果RecordCount是 0 且EOF为真，说明查询没返回数据。检查 SQL 语句里的表名和列名是否存在，或者 WHERE 条件是否过滤掉了所有行。如果RecordCount是 -1，说明游标类型不支持计数，换成adOpenStatic。
第五步，在while循环里下断点，看m_pRs->AbsolutePosition。第一条记录时是 1，每MoveNext一次加 1。如果AbsolutePosition返回 -1，说明游标不支持定位，还是游标类型问题。BOF和EOF在循环中的变化也能看出游标是否正常移动。
第六步，看 Output 窗口打印的字段值。如果值是乱码，检查数据库列的字符集和 VC6 工程的字符集设置。VC6 默认是 MBCS，如果数据库是 Unicode，需要转换。用_bstr_t转换时，_bstr_t内部是宽字符，转CString在 MBCS 工程下会走WideCharToMultiByte，一般没问题。如果乱码，试试CString strVal = (LPCTSTR)_bstr_t(vtVal);改成CString strVal; strVal = vtVal.bstrVal;看是否改善。
成功的结果长这样：Output 窗口依次打印连接成功、记录数、每行的字段值。比如：
连接成功, State=1 记录数=10, BOF=0, EOF=0 值=张三 值=李四 ...如果只打印了连接成功，没有记录数，说明m_pRs->Open抛异常了，被 catch 捕获。看 catch 里的e.Description()，通常会说明原因，比如“对象名 'YourTable' 无效”。
还有一个验证点：m_pConn->Errors->Count。连接失败时，Errors 集合里会有详细错误信息。加一段：
if (m_pConn->Errors->Count > 0) { for (long i = 0; i < m_pConn->Errors->Count; i++) { _com_error err(m_pConn->Errors->Item[i]->Number); TRACE(_T("错误 %d: %s\n"), i, (LPCTSTR)err.Description()); } }这段放在Open失败之后，能打印出比 hr 更具体的描述。
验证通过后，你就有了一个能跑通的 ADO 查询。下一节讲常见报错和排查方法，包括 401、local proxy failed、reading choices、OAuth 这些你可能遇到的错误。
5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth 报错怎么解
这一节对照真实报错给排查路径。这些错误不一定都出现在 VC6 里，但走统一 Key 通道时可能遇到。
401 Unauthorized。这是认证失败。在 ADO 场景里，表现为Open返回0x80040E4D或0x80004005，Errors 集合里提示“登录失败”。排查顺序：第一，Key 是否复制完整，有没有多余空格；第二，Key 是否过期或被删除，去 console 的 API Keys 页面确认状态；第三，连接串里的 UID 和 PWD 字段是否和通道要求的一致，有些通道要求 UID 固定为taotoken，PWD 放 Key；第四，如果通道要求 Bearer Token 而不是连接串认证，那 ADO 直连可能不支持，需要走 ODBC 或中间层。接入文档里会写明认证方式。
local proxy failed。这个错误通常出现在通过本地代理访问通道时。VC6 程序如果配了系统代理，ADO 的 HTTP 请求可能走代理失败。排查：第一，检查 IE 的代理设置（VC6 的 WinINet 会读这个），把代理关掉或配成通道要求的地址；第二，如果通道需要代理，确认代理地址和端口正确；第三，防火墙是否拦截了出站连接，临时关掉防火墙测试。注意，这里说的代理是网络配置层面的，不是让你去搞什么特殊网络工具，就是普通的 HTTP 代理设置。
reading choices 报错。这个错误一般出现在解析响应时，通道返回的 JSON 结构和你预期的不一致。比如你按模型对话的格式去解析数据库通道的响应，字段对不上。排查：第一，用模型对话页面或 curl 先测通道是否正常返回；第二，看接入文档里数据库通道的响应格式，确认字段名；第三，VC6 里如果自己解析 JSON，检查解析代码是否处理了错误分支。如果你用的是现成的 MCP server，看它的日志输出。
OAuth 相关报错。如果通道用 OAuth 认证，而你在连接串里直接放 Key，会报 token 无效。排查：第一，确认通道的认证方式是 API Key 还是 OAuth；第二，如果是 OAuth，需要先走授权流程拿 access token，再把 token 放进连接串；第三，token 有过期时间，过期后要刷新。VC6 里做 OAuth 比较麻烦，建议用 API Key 方式。如果文档说支持 API Key，就优先用 Key。
连接串格式错误。报错0x80040E21。排查：第一，每个字段用分号分隔，最后也要有分号；第二，值里如果有分号或等号，要用引号包起来；第三，Provider 名称拼写正确，SQLOLEDB不是SQLOLEDB.1（有些环境要加 .1）；第四，Server 字段如果是 IP 加端口，格式是Server=192.168.1.100,1433，逗号不是冒号。
Recordset 打开失败。报错0x80040E14一般是 SQL 语法错误。排查：第一，把 SQL 语句复制到查询分析器里单独执行；第二，检查表名和列名是否有保留字，有的话用方括号包起来；第三，SELECT *在有些视图上会失败，改成具体列名。
字段读取返回空。不是报错但结果不对。排查：第一，列名大小写，SQL Server 默认不区分，但有些排序规则区分；第二，GetItem的序号从 0 开始还是 1 开始，ADO 里Fields->Item[0]是第一列；第三，NULL 值判断，vt == VT_NULL时不要转字符串。
CC Switch / Cline MCP / Codex auth.json 配置错误。如果这三件套里缺了 Base URL、Key、Model ID 任何一个，都会连不上。检查 JSON 格式是否正确，字段名是否和文档一致。Cline MCP 的 env 里三个变量都要有。Codex 的 auth.json 里base_url不要带尾部斜杠，api_key不要带Bearer前缀。
排查完这些，大部分连接问题都能定位。如果还不行，去接入文档页面看最新的配置示例，或者用模型对话页面发一条测试消息，确认 Key 本身有效。
6. 从能连到能用：把 ADO 查询封装成可复用函数与后续接入建议
跑通第一个查询后，下一步是把代码封装成可复用的函数，避免每次写一堆重复的 try-catch。建议封装一个CAdoHelper类，提供Open、Query、Execute、Close方法。Query返回_RecordsetPtr，调用方自己遍历。Execute用于 INSERT/UPDATE/DELETE，返回影响行数。
封装时注意几点：第一，COM 初始化放在应用启动时做一次，不要每次查询都CoInitialize；第二，连接对象可以复用，不要每次查询都新建连接，连接池在 ADO 里是自动的，但频繁 Open/Close 有开销；第三，异常处理统一在 helper 里做，把_com_error转成错误码和描述返回给调用方；第四，Key 从配置文件读，不要硬编码。
如果你后续要做更复杂的场景，比如批量写入、事务、存储过程调用，ADO 都支持。事务用m_pConn->BeginTrans()、CommitTrans()、RollbackTrans()。存储过程用m_pConn->Execute("EXEC ProcName ?, ?", ...)或者_CommandPtr。这些在接入文档里也有示例。
对于长期编码和 Agent 场景，可以考虑用 Coding Plan，把数据库访问封装成工具函数，让 Agent 调用。Coding Plan 的接入方式和模型对话类似，endpoint 是 https://taotoken.net/api 加/coding-plan路径。如果你要管理多个 Key 或查看用量，去 console 页面。API Keys 管理在 https://taotoken.net/api-keys 。
最后给一个实用技巧：在 VC6 里调试 ADO 时，把TRACE输出重定向到文件，方便事后分析。在InitInstance里加：
#ifdef _DEBUG freopen("ado_debug.log", "w", stdout); #endif然后TRACE的内容会写到文件里。注意TRACE默认输出到 Output 窗口，重定向后两者都有。调试完记得关掉。
还有一个坑：VC6 的_variant_t在某些 SP 版本下有内存泄漏，频繁循环读取字段时注意。如果发现内存持续增长，把_variant_t改成variant_t或手动VariantClear。实测下来，用_variant_t配合Fields->GetItem在循环里一般没问题，但如果循环几十万次，建议用GetRows一次性取回数组再遍历。
到这里，从连接串配置到 Recordset 遍历的完整链路就走通了。你可以把代码复制进工程，改一下连接串里的 endpoint 和 Key，编译运行，看 Output 窗口的输出。如果遇到报错，回到第 5 节对照排查。需要创建 Key 或查看接入文档，去 console 和 doc 页面。
