若要访问 SQL Server Native Client OLE DB 访问接口,使用者必须先通过调用 CoCreateInstance 方法创建数据源对象的实例。 唯一类标识符 (CLSID) 标识每个 OLE DB 提供程序。 对于 SQL Server Native Client OLE DB 访问接口,类标识符CLSID_SQLNCLI10。 还可以使用符号SQLNCLI_CLSID解析为引用的 sqlncli.h 中使用的 SQL Server Native Client OLE DB 访问接口。
数据源对象公开 IDBProperties 接口,使用者使用该接口提供服务器名称、数据库名称、用户 ID 和密码等基本身份验证信息。 调用 IDBProperties::SetProperties 方法以设置这些属性。
如果计算机上运行了多个 SQL Server 实例,则服务器名称将指定为 ServerName\InstanceName。
数据源对象还公开 IDBInitialize 接口。 设置属性后,通过调用 IDBInitialize::Initialize 方法建立与数据源的连接。 例如:
CoCreateInstance(CLSID_SQLNCLI10,
NULL,
CLSCTX_INPROC_SERVER,
IID_IDBInitialize,
(void **) &pIDBInitialize)
对 CoCreateInstance 的调用将创建与CLSID_SQLNCLI10关联的类的单个对象(与将用于创建对象的数据和代码关联的 CSLID)。 IID_IDBInitialize是对用于与对象通信的接口(IDBInitialize)标识符的引用。
下面是一个示例函数,用于初始化和建立与数据源的连接。
void InitializeAndEstablishConnection() {
// Initialize the COM library.
CoInitialize(NULL);
// Obtain access to the SQL Server Native Client OLE DB provider.
hr = CoCreateInstance(CLSID_SQLNCLI10,
NULL,
CLSCTX_INPROC_SERVER,
IID_IDBInitialize,
(void **) &pIDBInitialize);
// Initialize property values needed to establish connection.
for (i = 0 ; i < 4 ; i++)
VariantInit(&InitProperties[i].vValue);
// Server name.
// See DBPROP structure for more information on InitProperties
InitProperties[0].dwPropertyID = DBPROP_INIT_DATASOURCE;
InitProperties[0].vValue.vt = VT_BSTR;
InitProperties[0].vValue.bstrVal=
SysAllocString(L"Server");
InitProperties[0].dwOptions = DBPROPOPTIONS_REQUIRED;
InitProperties[0].colid = DB_NULLID;
// Database.
InitProperties[1].dwPropertyID = DBPROP_INIT_CATALOG;
InitProperties[1].vValue.vt = VT_BSTR;
InitProperties[1].vValue.bstrVal= SysAllocString(L"database");
InitProperties[1].dwOptions = DBPROPOPTIONS_REQUIRED;
InitProperties[1].colid = DB_NULLID;
// Username (login).
InitProperties[2].dwPropertyID = DBPROP_AUTH_INTEGRATED;
InitProperties[2].vValue.vt = VT_BSTR;
InitProperties[2].vValue.bstrVal= SysAllocString(L"SSPI");
InitProperties[2].dwOptions = DBPROPOPTIONS_REQUIRED;
InitProperties[2].colid = DB_NULLID;
InitProperties[3].dwOptions = DBPROPOPTIONS_REQUIRED;
InitProperties[3].colid = DB_NULLID;
// Construct the DBPROPSET structure(rgInitPropSet). The
// DBPROPSET structure is used to pass an array of DBPROP
// structures (InitProperties) to the SetProperties method.
rgInitPropSet[0].guidPropertySet = DBPROPSET_DBINIT;
rgInitPropSet[0].cProperties = 4;
rgInitPropSet[0].rgProperties = InitProperties;
// Set initialization properties.
hr = pIDBInitialize->QueryInterface(IID_IDBProperties,
(void **)&pIDBProperties);
hr = pIDBProperties->SetProperties(1, rgInitPropSet);
pIDBProperties->Release();
// Now establish the connection to the data source.
pIDBInitialize->Initialize();
}