Establecer una conexión con un origen de datos
Para tener acceso al proveedor OLE DB de SQL Server Native Client, el consumidor debe crear primero una instancia de un objeto de origen de datos llamando al método CoCreateInstance. Un identificador de clase único (CLSID) identifica cada proveedor OLE DB. El identificador de clase del proveedor OLE DB de SQL Server Native Client es CLSID_SQLNCLI10. También puede utilizar el símbolo SQLNCLI_CLSID que se resolverá como el proveedor OLE DB de SQL Server Native Client utilizado en el sqlncli.h al que hace referencia.
El objeto de origen de datos expone la interfaz IDBProperties, que el consumidor utiliza para proporcionar información de autenticación básica como nombre de servidor, nombre de base de datos, identificador de usuario y contraseña. Se llama al método IDBProperties::SetProperties para establecer estas propiedades.
Si hay varias instancias de SQL Server ejecutándose en el equipo, el nombre de servidor se especifica como ServerName\InstanceName.
El objeto de origen de datos también expone la interfaz IDBInitialize. Una vez establecidas las propiedades, se establece la conexión al origen de datos llamando al método IDBInitialize::Initialize. Por ejemplo:
CoCreateInstance(CLSID_SQLNCLI10,
NULL,
CLSCTX_INPROC_SERVER,
IID_IDBInitialize,
(void **) &pIDBInitialize)
Esta llamada a CoCreateInstance crea un objeto único de la clase asociado a CLSID_SQLNCLI10 (CSLID asociado con los datos y el código que se utilizará para crear el objeto). IID_IDBInitialize es una referencia al identificador de la interfaz (IDBInitialize) que se va a utilizar para comunicar con el objeto.
La siguiente es una función de ejemplo que inicializa y establece una conexión al origen de datos. Para obtener información sobre el acceso a las aplicaciones de ejemplo de OLE DB, vea Consideraciones para instalar ejemplos y bases de datos de ejemplo de SQL Server.
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();
}