Partilhar via


Propriedades e comportamentos do conjunto de linhas

Estas são as propriedades do conjunto de linhas do provedor OLE DB do SQL Server Native Client.

ID da propriedade

Descrição

DBPROP_ABORTPRESERVE

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o comportamento de um conjunto de linhas depois de uma operação de anulação é determinado por esta propriedade.

VARIANT_FALSE: o provedor OLE DB do SQL Server Native Client invalida conjuntos de linhas depois de uma operação de anulação. A funcionalidade do objeto de conjunto de linhas está praticamente perdida. Ela dá suporte apenas para operações IUnknown e a versão de identificadores de linha e acessador pendentes.

VARIANT_TRUE: o provedor OLE DB do SQL Server Native Client mantém um conjunto de linhas válido.

DBPROP_ACCESSORDER

Leitura/gravação: leitura/gravação

Padrão: DBPROPVAL_AO_RANDOM

Descrição: ordem de acesso. A ordem em que as colunas devem ser acessadas no conjunto de linhas.

DBPROPVAL_AO_RANDOM: a coluna pode ser acessada em qualquer ordem.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: as colunas associadas como objetos de armazenamento podem apenas ser acessadas na ordem seqüencial determinada pelo ordinal de coluna.

DBPROPVAL_AO_SEQUENTIAL: todas as colunas devem ser acessadas na ordem seqüencial determinada pelo ordinal de coluna.

DBPROP_APPENDONLY

Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro.

DBPROP_BLOCKINGSTORAGEOBJECTS

Leitura/gravação: somente leitura

Padrão: VARIANT_TRUE

Descrição: os objetos de armazenamento do provedor OLE DB do SQL Server Native Client são bloqueados usando outros métodos de conjunto de linhas.

DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte a indicadores para identificação de linha do conjunto de linhas quando DBPROP_BOOKMARKS ou DBPROP_LITERALBOOKMARKS é VARIANT_TRUE.

A definição de qualquer uma das propriedades como VARIANT_TRUE não habilita o posicionamento do conjunto de linhas por indicador. Defina DBPROP_IRowsetLocate ou DBPROP_IRowsetScroll como VARIANT_TRUE para criar um conjunto de linhas que dê suporte ao posicionamento do conjunto de linhas por indicador.

O provedor OLE DB do SQL Server Native Client usa um cursor do MicrosoftSQL Server para dar suporte a um conjunto de linhas que contenha indicadores. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server.

ObservaçãoObservação
A definição destas propriedades em conflito com outras propriedades de definição de cursor do provedor OLE DB do SQL Server Native Client provoca um erro. Por exemplo, a definição de DBPROP_BOOKMARKS como VARIANT_TRUE quando DBPROP_OTHERINSERT também é VARIANT_TRUE gera um erro quando o consumidor tenta abrir um conjunto de linhas.

DBPROP_BOOKMARKSKIPPED

Leitura/gravação: somente leitura

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client retornará DB_E_BADBOOKMARK se o consumidor especificar um indicador inválido ao posicionar ou pesquisar um conjunto de linhas com indicadores.

DBPROP_BOOKMARKTYPE

Leitura/gravação: somente leitura

Padrão: DBPROPVAL_BMK_NUMERIC

Descrição: o provedor OLE DB do SQL Server Native Client implementa apenas indicadores numéricos. Um indicador do provedor OLE DB do SQL Server Native Client é um número inteiro sem sinal de 32 bits, tipo DBTYPE_UI4.

DBPROP_CACHEDEFERRED

Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro.

DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte à busca e rolagem regressiva em conjuntos de linhas não seqüenciais. O provedor OLE DB do SQL Server Native Client cria um conjunto de linhas com suporte de cursor quando DBPROP_CANFETCHBACKWARDS ou DBPROP_CANSCROLLBACKWARDS é VARIANT_TRUE. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server.

DBPROP_CANHOLDROWS

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: por padrão, o provedor OLE DB do SQL Server Native Client retornará DB_E_ROWSNOTRELEASED se o consumidor tentar obter mais linhas para um conjunto de linhas enquanto existirem alterações pendentes nessas linhas atualmente no conjunto. Este comportamento pode ser modificado.

A definição de DBPROP_CANHOLDROWS e DBPROP_IRowsetChange como VARIANT_TRUE implica um conjunto de linhas com indicadores. Se as duas propriedades forem VARIANT_TRUE, a interface IRowsetLocate estará disponível no conjunto de linhas e DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS serão ambos VARIANT_TRUE.

Os conjuntos de linhas do provedor OLE DB do SQL Server Native Client que contêm indicadores têm suporte dos cursores do SQL Server.

DBPROP_CHANGEINSERTEDROWS

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: esta propriedade só poderá ser definida como VARIANT_TRUE se o conjunto de linhas estiver usando um cursor controlado por conjunto de chaves.

DBPROP_COLUMNRESTRICT

Leitura/gravação: somente leitura

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client define a propriedade como VARIANT_TRUE quando uma coluna em um conjunto de linhas não pode ser alterada pelo consumidor. Outras colunas no conjunto de linhas podem ser atualizáveis e as linhas em si podem ser excluídas.

Quando a propriedade é VARIANT_TRUE, o consumidor examina o membro dwFlags da estrutura DBCOLUMNINFO para determinar se o valor de uma coluna individual poderá ser gravado ou não. Para colunas modificáveis, dwFlags exibe DBCOLUMNFLAGS_WRITE.

DBPROP_COMMANDTIMEOUT

Leitura/gravação: leitura/gravação

Padrão: 0

Descrição: por padrão, o tempo limite do provedor OLE DB do SQL Server Native Client não se esgota no método ICommand::Execute.

DBPROP_COMMITPRESERVE

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o comportamento de um conjunto de linhas depois de uma operação de confirmação é determinado por esta propriedade.

VARIANT_TRUE: o provedor OLE DB do SQL Server Native Client mantém um conjunto de linhas válido.

VARIANT_FALSE: o provedor OLE DB do SQL Server Native Client invalida conjuntos de linhas depois de uma operação de confirmação. A funcionalidade do objeto de conjunto de linhas está praticamente perdida. Ela dá suporte apenas para operações IUnknown e a versão de identificadores de linha e acessador pendentes.

DBPROP_DEFERRED

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: em caso de definição como VARIANT_TRUE, o provedor OLE DB do SQL Server Native Client tenta usar um cursor de servidor para o conjunto de linhas. As colunas Text, ntext e image não são retornadas do servidor até serem acessadas pelo aplicativo.

DBPROP_DELAYSTORAGEOBJECTS

Leitura/gravação: somente leitura

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte ao modo de atualização imediata em objetos de armazenamento.

As alterações feitas a dados em um objeto de fluxo seqüencial são imediatamente enviadas para o SQL Server. As modificações são confirmadas com base no modo de transação de conjunto de linhas.

DBPROP_HIDDENCOLUMNS

Leitura/gravação: somente leitura

Padrão: VARIANT_FALSE

Descrição: contagem de coluna oculta

Se DBPROP_UNIQUEROWS for VARIANT_TRUE, a propriedade DBPROP_HIDDENCOLUMNS retornará o número de colunas "ocultas" adicionais incluídas pelo provedor para identificar com exclusividade as linhas dentro do conjunto de linhas. Essas colunas são retornadas por IColumnsInfo::GetColumnInfo e IColumnsRowset::GetColumnsRowset. No entanto, elas não são incluídas na contagem de linhas retornadas pelo argumento pcColumns retornado por IColumnsInfo::GetColumnInfo.

Para determinar o número total de colunas representadas na estrutura prgInfo retornada por IColumnsInfo::GetColumnInfo, incluindo as colunas ocultas, o consumidor adicionará o valor de DBPROP_HIDDENCOLUMNS à contagem de colunas retornadas de IColumnsInfo::GetColumnInfo em pcColumns. Se DBPROP_UNIQUEROWS for VARIANT_FALSE, DBPROP_HIDDENCOLUMNS será zero.

DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo

Leitura/gravação: somente leitura

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para estas interfaces em todos os conjuntos de linhas.

DBPROP_IColumnsRowset

Leitura/gravação: leitura/gravação

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para a interface IColumnsRowset.

DBPROP_IConnectionPointContainer

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: IConnectionPointContainer. Se for VARIANT_TRUE, o conjunto de linhas terá suporte para a interface especificada. Se for VARIANT_FALSE, o conjunto de linhas não terá suporte para a interface especificada. Os provedores que têm suporte para a interface devem aceitar a propriedade associada a essa interface com um valor de VARIANT_TRUE. Essas propriedades são usadas para solicitar interfaces por ICommandProperties::SetProperties.

DBPROP_IMultipleResults

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client tem suporte para a interface IMultipleResults.

DBPROP_IRowsetChange DBPROP_IRowsetUpdate

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para as interfaces IRowsetChange e IRowsetUpdate.

Um conjunto de linhas criado usando DBPROP_IRowsetChange igual a VARIANT_TRUE exibe comportamentos de modo de atualização imediatos.

Quando DBPROP_IRowsetUpdate é VARIANT_TRUE, DBPROP_IRowsetChange também é VARIANT_TRUE. O conjunto de linhas exibe comportamento de modo de atualização com atraso.

O provedor OLE DB do SQL Server Native Client usa um cursor do SQL Server para dar suporte a conjuntos de linhas que expõem IRowsetChange ou IRowsetUpdate. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server.

DBPROP_IRowsetIdentity

Leitura/gravação: leitura/gravação

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para a interface IRowsetIdentity. Se um conjunto de linhas der suporte para essa interface, qualquer uma das duas alças de linha que represente a mesma linha subjacente sempre refletirá os mesmos dados e estado. Consumidores podem chamar o método IRowsetIdentity:: IsSameRow para comparar duas alças de linha para ver se elas se referem à mesma instância de linha.

DBPROP_IRowsetLocate DBPROP_IRowsetScroll

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client pode expor as interfaces IRowsetLocate e IRowsetScroll.

Quando DBPROP_IRowsetLocate é VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS e DBPROP_CANSCROLLBACKWARDS também são VARIANT_TRUE.

Quando DBPROP_IRowsetScroll é VARIANT_TRUE, DBPROP_IRowsetLocate também é VARIANT_TRUE e ambas as interfaces estão disponíveis no conjunto de linhas.

São exigidos indicadores para qualquer interface. O provedor OLE DB do SQL Server Native Client define DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS como VARIANT_TRUE quando o consumidor solicita qualquer uma das interfaces.

O provedor OLE DB do SQL Server Native Client usa cursores do SQL Server para dar suporte a IRowsetLocate e IRowsetScroll. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server.

A definição destas propriedades em conflito com outras propriedades de definição de cursor do provedor OLE DB do SQL Server Native Client provoca um erro. Por exemplo, a definição de DBPROP_IRowsetScroll como VARIANT_TRUE quando DBPROP_OTHERINSERT também é VARIANT_TRUE gera um erro quando o consumidor tenta abrir um conjunto de linhas.

DBPROP_IRowsetResynch

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client expõe a interface IRowsetResynch sob demanda. O provedor OLE DB do SQL Server Native Client pode expor a interface em qualquer conjunto de linhas.

DBPROP_ISupportErrorInfo

Leitura/gravação: leitura/gravação

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB do SQL Server Native Client expõe a ISupportErrorInfo em conjuntos de linhas.

DBPROP_ILockBytes

Esta interface não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar a propriedade gera um erro.

DBPROP_ISequentialStream

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client expõe a interface ISequentialStream para dar suporte a dados de comprimento variável e longo armazenados no SQL Server.

DBPROP_IStorage

Esta interface não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar a propriedade gera um erro.

DBPROP_IStream

Esta interface não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar a propriedade gera um erro.

DBPROP_IMMOBILEROWS

Leitura/gravação: leitura/gravação

Padrão: VARIANT_TRUE

Descrição: a propriedade só é VARIANT_TRUE para cursores de conjunto de chaves do SQL Server; é VARIANT_FALSE para todos os outros cursores.

VARIANT_TRUE: o conjunto de linhas não reorganizará as linhas inseridas ou atualizadas. Para IRowsetChange::InsertRow, as linhas serão exibidas no fim do conjunto de linhas. Para IRowsetChange::SetData, se o conjunto de linhas não for ordenado, a posição das linhas atualizadas não será alterada. Se o conjunto de linhas for ordenado e IRowsetChange::SetData alterar uma coluna que é usada para ordenar o conjunto de linhas, a linha não será movida. Se o conjunto de linhas for criado em um conjunto de colunas-chave (geralmente, um conjunto de linhas para o qual DBPROP_OTHERUPDATEDELETE é VARIANT_TRUE, mas DBPROP_OTHERINSERT é VARIANT_FALSE), a alteração do valor de uma coluna-chave será geralmente equivalente à exclusão da linha atual e à inserção de uma nova linha. Portanto, a linha poderá parecer mover ou até mesmo desaparecer do conjunto de linhas, se DBPROP_OWNINSERT for VARIANT_FALSE, embora a propriedade DBPROP_IMMOBILEROWS seja VARIANT_TRUE.

VARIANT_FALSE: se o conjunto de linhas for ordenado, as linhas inseridas serão exibidas na ordem correta do conjunto de linhas. Se o conjunto de linhas não for ordenado, a linha inserida aparecerá no final. Se IRowsetChange::SetData alterar uma coluna que é usada para ordenar o conjunto de linhas, a linha será movida. Se o conjunto de linhas não for ordenado, a posição da linha não será alterada.

DBPROP_LITERALIDENTITY

Leitura/gravação: somente leitura

Padrão: VARIANT_TRUE

Descrição: esta propriedade é sempre VARIANT_TRUE.

DBPROP_LOCKMODE

Leitura/gravação: leitura/gravação

Padrão: DBPROPVAL_LM_NONE

Descrição: nível de bloqueio executado pelo conjunto de linhas (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW).

ObservaçãoObservação
Ao usar o isolamento do instantâneo em uma transação, se um conjunto de linhas for aberto usando um conjunto de chaves ou um cursor de servidor dinâmico e o modo de bloqueio estiver definido como DBPROPVAL_LM_SINGLEROW, ocorrerá um erro durante a busca de uma linha se algum outro usuário tiver atualizado essa linha desde que a transação foi iniciada. Para outros tipos de cursor e modos de bloqueio, se algum outro usuário tiver atualizado a linha desde o início da transação, não ocorrerá um erro até o usuário tentar atualizar a linha. Em ambos os casos, esses erros são gerados pelo servidor.

DBPROP_MAXOPENROWS

Leitura/gravação: somente leitura

Padrão: 0

Descrição: o provedor OLE DB do SQL Server Native Client não limita o número de linhas que podem estar ativas em conjuntos de linhas.

DBPROP_MAXPENDINGROWS

Leitura/gravação: somente leitura

Padrão: 0

Descrição: o provedor OLE DB do SQL Server Native Client não limita o número de linhas do conjunto de linhas com alterações pendentes.

DBPROP_MAXROWS

Leitura/gravação: leitura/gravação

Padrão: 0

Descrição: por padrão, o provedor OLE DB do SQL Server Native Client não limita o número de linhas em um conjunto de linhas. Quando o consumidor define DBPROP_MAXROWS, o provedor OLE DB do SQL Server Native Client usa a instrução SET ROWCOUNT para limitar o número de linhas no conjunto de linhas.

SET ROWCOUNT pode causar conseqüências não intencionais na execução de instrução do SQL Server. Para obter mais informações, consulte SET ROWCOUNT.

DBPROP_MAYWRITECOLUMN

Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro.

DBPROP_MEMORYUSAGE

Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro.

DBPROP_NOTIFICATIONGRANULARITY

Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro.

DBPROP_NOTIFICATIONPHASES

Leitura/gravação: somente leitura

Padrão: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte a todas as fases de notificação.

DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE

Leitura/gravação: somente leitura

Padrão: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

Descrição: as fases de notificação do provedor OLE DB do SQL Server Native Client podem ser canceladas antes de uma tentativa para executar a modificação de conjunto de linhas indicada. O provedor OLE DB do SQL Server Native Client não dá suporte ao cancelamento de fase após a conclusão da tentativa.

DBPROP_ORDEREDBOOKMARKS

Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro.

DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: a definição de propriedades de visibilidade de alterações faz com que o provedor OLE DB do SQL Server Native Client use cursores do SQL Server para dar suporte ao conjunto de linhas. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server.

DBPROP_QUICKRESTART

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: em caso de definição como VARIANT_TRUE, o provedor OLE DB do SQL Server Native Client tenta usar um cursor de servidor para o conjunto de linhas.

DBPROP_REENTRANTEVENTS

Leitura/gravação: somente leitura

Padrão: VARIANT_TRUE

Descrição: os conjuntos de linhas do provedor OLE DB do SQL Server Native Client são reentrantes e poderão retornar DB_E_NOTREENTRANT se um consumidor tentar acessar um método de conjunto de linhas não-reentrante de um retorno de chamada de notificação.

DBPROP_REMOVEDELETED

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client altera o valor da propriedade com base na visibilidade de alterações feitas nos dados do SQL Server expostos pelo conjunto de linhas.

VARIANT_TRUE: as linhas excluídas pelo consumidor ou outros usuários do SQL Server são removidos do conjunto de linhas quando o conjunto de linhas é atualizado. DBPROP_OTHERINSERT é VARIANT_TRUE.

VARIANT_ FALSE: as linhas excluídas pelo consumidor ou outros usuários do SQL Server não são removidos do conjunto de linhas quando o conjunto de linhas é atualizado. O valor de status de linha para linhas excluídas do SQL Server no conjunto de linhas é DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT é VARIANT_TRUE.

Esta propriedade só tem valor para conjuntos de linhas com suporte de cursores do SQL Server. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server.

Quando a propriedade DBPROP_REMOVEDELETED é implementada em um conjunto de linhas de cursor do conjunto de chaves, as linhas excluídas são removidas no momento da busca e é possível para os métodos de busca de linhas, como GetNextRows e GetRowsAt, retornar S_OK e menos linhas do que solicitado. Observe que este comportamento não significa que a condição DB_S_ENDOFROWSET e que o número de linhas retornadas nunca serão zero se houver alguma linha restante.

DBPROP_REPORTMULTIPLECHANGES

Esta propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. A tentativa de ler ou gravar o valor da propriedade gera um erro.

DBPROP_RETURNPENDINGINSERTS

Leitura/gravação: somente leitura

Padrão: VARIANT_FALSE

Descrição: quando um método que busca linhas é chamado, o provedor OLE DB do SQL Server Native Client não retorna linhas de inserção pendentes.

DBPROP_ROWRESTRICT

Leitura/gravação: somente leitura

Padrão: VARIANT_TRUE

Descrição: os conjuntos de linhas do provedor OLE DB do SQL Server Native Client não dão suporte para direitos de acesso baseados na linha. Se a interface IRowsetChange for exposta em um conjunto de linhas, o método SetData poderá ser chamado pelo consumidor.

DBPROP_ROWSET_ASYNCH

Leitura/gravação: leitura/gravação

Padrão: 0

Descrição: fornece processamento de conjunto de linhas assíncrono. Esta propriedade está no grupo de propriedades Conjunto de linhas e no conjunto de propriedades DBPROPSET_ROWSET. Tipo é VT_14.

O único valor na máscara de bits suportado pelo SQL Server Native Client é DBPROPVAL_ASYNCH_INITIALIZE.

DBPROP_ROWTHREADMODEL

Leitura/gravação: somente leitura

Padrão: DBPROPVAL_RT_FREETHREAD

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para o acesso a seus objetos de vários threads de execução de um único consumidor.

DBPROP_SERVERCURSOR

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: em caso de uma definição, um cursor do SQL Server é usado para dar suporte ao conjunto de linhas. Para obter mais informações, consulte Conjuntos de linha e cursores do SQL Server.

DBPROP_SERVERDATAONINSERT

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: dados de servidor na inserção.

VARIANT_TRUE: no momento em que uma inserção é transmitida ao servidor, o provedor recupera dados do servidor para atualizar o cache de linha local.

VARIANT_FALSE: o provedor não recupera valores de servidor para linhas recentemente inseridas.

DBPROP_STRONGIDENTITY

Leitura/gravação: somente leitura

Padrão: VARIANT_TRUE

Descrição: identidade de linha forte. Se forem permitidas inserções em um conjunto de linhas (IRowsetChange ou IRowsetUpdate será true), e DBPROP_UPDATABILITY for definida para dar suporte a InsertRows, o valor de DBPROP_STRONGIDENTITY dependerá da propriedade DBPROP_CHANGEINSERTEDROWS (será VARIANT_FALSE se o valor da propriedade DBPROP_CHANGEINSERTEDROWS for VARIANT_FALSE).

DBPROP_TRANSACTEDOBJECT

Leitura/gravação: somente leitura

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte apenas para objetos transacionados. Para obter mais informações, consulte Transações.

DBPROP_UNIQUEROWS

Leitura/gravação: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: linhas exclusivas.

VARIANT_TRUE: cada linha é identificada exclusivamente por seus valores de coluna. O conjunto de colunas que identificam exclusivamente a linha tem a propriedade DBCOLUMNFLAGS_KEYCOLUMN definida na estrutura DBCOLUMNINFO retornada do método GetColumnInfo.

VARIANT_FALSE: as linhas podem ou não ser identificadas exclusivamente por seus valores de coluna. As colunas de chave podem ou não ser sinalizadas com DBCOLUMNFLAGS_KEYCOLUMN.

DBPROP_UPDATABILITY

Leitura/gravação: leitura/gravação

Padrão: 0

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte para todos os valores de DBPROP_UPDATABILITY. A definição de DBPROP_UPDATABILITY não cria um conjunto de linhas modificável. Para tornar um conjunto de linhas modificável, defina DBPROP_IRowsetChange ou DBPROP_IRowsetUpdate.

O provedor OLE DB do SQL Server Native Client define o conjunto de propriedades específico do provedor, DBPROPSET_SQLSERVERROWSET, como mostrado nesta tabela.

ID da propriedade

Descrição

SSPROP_COLUMN_ID

Coluna: ColumnID

Leitura/gravação: somente leitura

Tipo: VT_U12 | VT_ARRAY

Padrão: VT_EMPTY

Descrição: uma matriz de valores de número inteiro que representam a posição ordinal (de base 1) de uma coluna de resultados da cláusula COMPUTE dentro da instrução Transact-SQL SELECT atual. Este é o provedor OLE DB do SQL Server Native Client equivalente do atributo SQL_CA_SS_COLUMN_ID do ODBC.

SSPROP_COMPUTE_BYLIST

Coluna: ComputeByList

Leitura/gravação: somente leitura

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

Descrição: um valor booleano que indica que a coluna faz parte do conjunto de resultados COMPUTE BY. Este é o provedor OLE DB do SQL Server Native Client equivalente do atributo SQL_CA_SS_COMPUTE_BYLIST do ODBC.

ObservaçãoObservação
A propriedade OLE DB é um valor booleano, mas o atributo do ODBC é realmente uma lista de valores resumidos não assinados com todos os ordinais de coluna fazendo parte de uma cláusula BY.

VARIANT_TRUE: a coluna se origina em uma instrução COMPUTE BY.

VARIANT_FALSE: a coluna é uma coluna normal; não se origina na instrução COMPUTE BY.

SSPROP_COMPUTE_ID

Coluna: ComputeID

Leitura/gravação: somente leitura

Tipo: VT_U12

Padrão: 0

Descrição: a ID de cálculo de uma linha que é o resultado de uma cláusula COMPUTE na instrução Transact-SQL SELECT atual. Este é o provedor OLE DB do SQL Server Native Client equivalente do atributo SQL_CA_SS_COMPUTE_ID do ODBC.

SSPROP_DEFERPREPARE

Coluna: Não

Leitura/gravação: leitura/gravação

Tipo: VT_BOOL

Padrão: VARIANT_TRUE

Descrição: VARIANT_TRUE: na execução preparada, a preparação de comando é adiada até que ICommand::Execute é chamada ou uma operação de metapropriedade é executada. Se a propriedade for definida como

VARIANT_FALSE: a instrução está preparada quando ICommandPrepare::Prepare é executada.

SSPROP_IRowsetFastLoad

Coluna: Não

Leitura/gravação: leitura/gravação

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

Descrição: defina esta propriedade como VARIANT_TRUE para abrir um conjunto de linhas de carga rápida por IOpenRowset::OpenRowset. Você não pode definir essa propriedade em ICommandProperties::SetProperties.

SSPROP_ISSAsynchStatus

Coluna: Não

Leitura/gravação: leitura/gravação

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

Descrição: defina esta propriedade como VARIANT_TRUE para habilitar operações assíncronas que usam a interface ISSAsynchStatus.

SSPROP_MAXBLOBLENGTH

Coluna: Não

Leitura/gravação: leitura/gravação

Tipo: VT_I4

Padrão: o provedor não restringe o tamanho do texto retornado pelo servidor e o valor da propriedade é definido como seu máximo. Por exemplo, 2147483647.

Descrição: o provedor OLE DB do SQL Server Native Client executa uma instrução SET TEXTSIZE para restringir o comprimento dos dados BLOB (Objeto Binário Grande) retornados em uma instrução SELECT.

SSPROP_NOCOUNT_STATUS

Coluna: NoCount

Leitura/gravação: somente leitura

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

Descrição: um valor booleano que representa o status de SET NOCOUNT ON/OFF no SQL Server:

VARIANT_TRUE: quando SET NOCOUNT ON

VARIANT_FALSE: quando SET NOCOUNT OFF

SSPROP_QP_NOTIFICATION_MSGTEXT

Coluna: Não

Leitura/gravação: leitura/gravação

Tipo: VT_BSTR (1 a 2.000 caracteres permitidos)

Padrão: cadeia de caracteres vazia

Descrição: o texto de mensagem da notificação de consulta. Esta propriedade é definida pelo usuário e não tem nenhum formato definido.

SSPROP_QP_NOTIFICATION_OPTIONS

Coluna: Não

Leitura/gravação: leitura/gravação

Tipo: VT_BSTR

Padrão: cadeia de caracteres vazia

Descrição: as opções de notificação de consulta. Essas opções são especificadas em uma cadeia de caracteres com name=value. O usuário é responsável por criar o serviço e ler as notificações da fila. A sintaxe da cadeia de caracteres das opções de notificação de consulta é a seguinte:

service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]

Por exemplo:

service=mySSBService;local database=mydb

SSPROP_QP_NOTIFICATION_TIMEOUT

Coluna: Não

Leitura/gravação: leitura/gravação

Tipo: VT_UI4

Padrão: 432.000 segundos (5 dias)

Mínimo: 1 segundo

Máximo: 2^31-1 segundos

Descrição: o número de segundos que a notificação de consulta permanece ativa.

Histórico de alterações

Conteúdo atualizado

A descrição de DBPROP_ROWSET_ASYNCH foi atualizada.

Consulte também

Conceitos