Usando o método Seek com o OLE DB
O método Seek é o mais usado pelos clientes em índices do Microsoft SQL Server Compact 3.5. O Seek permite localizar rápido linhas em um cursor.
Usando o método Seek
Para funcionar corretamente, o método Seek requer a definição de um índice nas colunas da chave de pesquisa. A maioria das operações de busca se refere a um valor em particular, mas também é possível efetuar a busca usando outros operadores de comparação, como "maior que" ou "menor que".
IRowsetIndex::Seek passa valores para o provedor usando o mecanismo acessador no OLE DB que é usado para obter e definir dados. Os acessadores usados no método Seekpossuem restrições adicionais em relação a acessadores para IRowset::GetData e IRowset::SetData. O acessador deve associar colunas na ordem em que elas aparecem na chave de índice.
Só há suporte para a interface IRowsetPosition em cursores roláveis.
Exemplos
O exemplo a seguir mostra como usar o método IRowsetIndex::Seek em um índice que usa o provedor OLE DB para SQL Server Compact 3.5. O exemplo contém apenas as seções da função relacionada ao método Seek.
O exemplo a seguir foi atualizado para plataformas de 32 e 64 bits.. Os tipos compatíveis de 64 bits são do arquivo de cabeçalho nativo sqlce_oledb.h. Você pode encontrar o arquivo de cabeçalho nativo sqlce_oledb.h na pasta %Arquivos de Programas%\Microsoft SQL Server Compact Edition\v3.5\Include. Para obter mais informações, consulte o tópico de Informações de 64 bits do OLE DB na Guia do Programador do OLE DB no site da Microsoft.
TableID.eKind = DBKIND_NAME;
TableID.uName.pwszName = (WCHAR*)TABLE_EMPLOYEE;
IndexID.eKind = DBKIND_NAME;
IndexID.uName.pwszName = L"PK_Employees";
// Request ability to use IRowsetChange interface.
rowsetpropset[0].cProperties = 1;
rowsetpropset[0].guidPropertySet = DBPROPSET_ROWSET;
rowsetpropset[0].rgProperties = rowsetprop;
rowsetprop[0].dwPropertyID = DBPROP_IRowsetIndex;
rowsetprop[0].dwOptions = DBPROPOPTIONS_REQUIRED;
rowsetprop[0].colid = DB_NULLID;
rowsetprop[0].vValue.vt = VT_BOOL;
rowsetprop[0].vValue.boolVal = VARIANT_TRUE;
// Open the table using the index.
hr = pIOpenRowset->OpenRowset(NULL, &TableID, &IndexID,
IID_IRowsetIndex, sizeof(rowsetpropset)/sizeof(rowsetpropset[0]),
rowsetpropset, (IUnknown**) &pIRowsetIndex);
if(FAILED(hr))
{
goto Exit;
}
// Get the IRowset interface.
hr = pIRowsetIndex->QueryInterface(IID_IRowset, (void**) &pIRowset);
if(FAILED(hr))
{
goto Exit;
}
///////////////////////////////////////////////////////////////////////
// Steps to get column data using IcolumnsInfo have been removed
///////////////////////////////////////////////////////////////////////
// Create a DBBINDING array.
dwBindingSize = sizeof(pwszEmployees)/sizeof(pwszEmployees[0]);
prgBinding = (DBBINDING*)CoTaskMemAlloc(sizeof(DBBINDING)*dwBindingSize);
if (NULL == prgBinding)
{
hr = E_OUTOFMEMORY;
goto Exit;
}
// Set initial offset for binding position.
dwOffset = 0;
// Prepare structures to create an accessor for each index.
for (dwIndex = 0; dwIndex < dwBindingSize; ++dwIndex)
{
if (!GetColumnOrdinal(pDBColumnInfo, ulNumCols, pwszEmployees[dwIndex], &dwOrdinal))
{
hr = E_FAIL;
goto Exit;
}
prgBinding[dwIndex].iOrdinal = dwOrdinal;
prgBinding[dwIndex].dwPart = DBPART_VALUE | DBPART_STATUS | DBPART_LENGTH;
prgBinding[dwIndex].obLength = dwOffset;
prgBinding[dwIndex].obStatus = prgBinding[dwIndex].obLength + sizeof(DBLENGTH);
prgBinding[dwIndex].obValue = prgBinding[dwIndex].obStatus + sizeof(DBSTATUS);
prgBinding[dwIndex].pTypeInfo = NULL;
prgBinding[dwIndex].pBindExt = NULL;
prgBinding[dwIndex].dwMemOwner = DBMEMOWNER_CLIENTOWNED;
prgBinding[dwIndex].dwFlags = 0;
prgBinding[dwIndex].bPrecision = pDBColumnInfo[dwOrdinal].bPrecision;
prgBinding[dwIndex].bScale = pDBColumnInfo[dwOrdinal].bScale;
///////////////////////////////////////////////////////////////////////
// Case-specific binding information has been removed.
///////////////////////////////////////////////////////////////////////
prgBinding[dwIndex].pObject NULL;
prgBinding[dwIndex].wType = pDBColumnInfo[dwOrdinal].wType;
if(DBTYPE_WSTR == pDBColumnInfo[dwOrdinal].wType)
{
prgBinding[dwIndex].cbMaxLen = pDBColumnInfo[dwOrdinal].ulColumnSize
* sizeof(WCHAR);
}
else
{
prgBinding[dwIndex].cbMaxLen = pDBColumnInfo[dwOrdinal].ulColumnSize;
}
// Calculate and align the offset.
}
// Get IAccessor interface.
hr = pIRowset->QueryInterface(IID_IAccessor, (void**)&pIAccessor);
if(FAILED(hr))
{
goto Exit;
}
// Create the accessor.
hr = pIAccessor->CreateAccessor(DBACCESSOR_ROWDATA, dwBindingSize,
prgBinding, 0, &hAccessor, NULL);
if(FAILED(hr))
{
goto Exit;
}
// Allocate data buffer for seek and retrieve operation.
pData = (BYTE*)CoTaskMemAlloc(dwOffset);
if (NULL == pData)
{
hr = E_OUTOFMEMORY;
goto Exit;
}
// Set data buffer to zero.
//
memset(pData, 0, dwOffset);
// Set data buffer for seek operation by specifying the
// dwEmployeeID variable that is passed to the function.
*(DBLENGTH*)(pData+prgBinding[0].obLength) = 4;
*(DBSTATUS*)(pData+prgBinding[0].obStatus) = DBSTATUS_S_OK;
*(int*)(pData+prgBinding[0].obValue) = dwEmployeeID;
// Seek for the first row where the value of the selected column
// is dwEmployeeID.
hr = pIRowsetIndex->Seek(hAccessor, 1, pData, DBSEEK_FIRSTEQ);
if(FAILED(hr))
{
goto Exit;
}
// Retrieve a row handle for the row resulting from the seek.
hr = pIRowset->GetNextRows(DB_NULL_HCHAPTER, 0, 1, &cRowsObtained,
&prghRows);
if(FAILED(hr))
{
goto Exit;
}
///////////////////////////////////////////////////////////////////////
// Perform programming logic here on the
// returned rowset, and then release the rowset.
///////////////////////////////////////////////////////////////////////
Exit:
///////////////////////////////////////////////////////////////////////
// This is where the resources are released.
///////////////////////////////////////////////////////////////////////
return hr;