Compartilhar via


Propriedades e comportamentos do conjunto de linhas

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

ID da propriedade Descrição
DBPROP_ABORTPRESERVE L/G: 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 SQL Server Native Client invalida conjuntos de linhas após uma operação de anulação. A funcionalidade do objeto de conjunto de linhas está praticamente perdida. Ela dá suporte apenas a operações IUnknown e à versão de identificadores de linha e de acessador pendentes.

VARIANT_TRUE: o provedor OLE DB SQL Server Native Client mantém um conjunto de linhas válido.
DBPROP_ACCESSORDER L/G: 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 sequencial determinada pelo ordinal da coluna.

DBPROPVAL_AO_SEQUENTIAL: todas as colunas precisam ser acessadas na ordem sequencial determinada pelo ordinal da coluna.
DBPROP_APPENDONLY Essa 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 L/G: Somente leitura

Padrão: VARIANT_TRUE

Descrição: o SQL Server Native Client os objetos de armazenamento do provedor OLE DB bloqueiam o uso de outros métodos de conjunto de linhas.
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB SQL Server Native Client dá suporte a indicadores para identificação de linha de 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 Microsoft SQL Server para dar suporte a um conjunto de linhas que contém indicadores. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server. Nota: Definir essas propriedades em conflito com outras SQL Server Native Client propriedades de definição de cursor do provedor OLE DB causa 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 L/G: Somente leitura

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB SQL Server Native Client retornará DB_E_BADBOOKMARK se o consumidor indicar um indicador inválido ao posicionar ou pesquisar um conjunto de linhas com indicadores.
DBPROP_BOOKMARKTYPE L/G: Somente leitura

Padrão: DBPROPVAL_BMK_NUMERIC

Descrição: o provedor OLE DB SQL Server Native Client implementa apenas indicadores numéricos. Um indicador SQL Server Native Client provedor OLE DB é um inteiro sem sinal de 32 bits, tipo DBTYPE_UI4.
DBPROP_CACHEDEFERRED Essa 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 L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte à busca e rolagem de versões anteriores em conjuntos de linhas não sequenciais. O provedor OLE DB 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, confira Conjuntos de linha e cursores do SQL Server.
DBPROP_CANHOLDROWS L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: por padrão, o provedor OLE DB SQL Server Native Client retornará DB_E_ROWSNOTRELEASED se o consumidor tentar obter mais linhas para um conjunto de linhas enquanto houver alterações pendentes naqueles atualmente no conjunto de linhas. 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 VARIANT_TRUE.

SQL Server Native Client conjuntos de linhas do provedor OLE DB que contêm indicadores são compatíveis com cursores SQL Server.
DBPROP_CHANGEINSERTEDROWS L/G: 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 L/G: Somente leitura

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB 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 pode ser gravado ou não. Para colunas modificáveis, dwFlags exibe DBCOLUMNFLAGS_WRITE.
DBPROP_COMMANDTIMEOUT L/G: Leitura/gravação

Padrão: 0

Descrição: por padrão, o provedor OLE DB SQL Server Native Client não atingiu o tempo limite no método ICommand::Execute.
DBPROP_COMMITPRESERVE L/G: 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 SQL Server Native Client mantém um conjunto de linhas válido.

VARIANT_FALSE: o provedor OLE DB SQL Server Native Client invalida conjuntos de linhas após uma operação de confirmação. A funcionalidade do objeto de conjunto de linhas está praticamente perdida. Ela dá suporte apenas a operações IUnknown e à versão de identificadores de linha e de acessador pendentes.
DBPROP_DEFERRED L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: quando definido como VARIANT_TRUE o provedor OLE DB 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 enquanto não são acessadas pelo aplicativo.
DBPROP_DELAYSTORAGEOBJECTS L/G: 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 sequencial 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 L/G: Somente leitura

Padrão: VARIANT_FALSE

Descrição: contagem de colunas ocultas

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 colunas ocultas, o consumidor adiciona 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 L/G: Somente leitura

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte a essas interfaces em todos os conjuntos de linhas.
DBPROP_IColumnsRowset L/G: Leitura/gravação

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte à interface IColumnsRowset.
DBPROP_IConnectionPointContainer L/G: 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 L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte à interface IMultipleResults.
DBPROP_IRowsetChange DBPROP_IRowsetUpdate L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte às 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 SQL Server Native Client usa um cursor SQL Server para dar suporte a conjuntos de linhas que expõem IRowsetChange ou IRowsetUpdate. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server.
DBPROP_IRowsetIdentity L/G: Leitura/gravação

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte à 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. Os consumidores podem chamar o método IRowsetIdentity:: IsSameRow para comparar dois identificadores de linha para ver se eles se referem à mesma instância de linha.
DBPROP_IRowsetLocate DBPROP_IRowsetScroll L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB 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 SQL Server Native Client define DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS para VARIANT_TRUE quando o consumidor solicita uma das interfaces.

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

Definir essas propriedades em conflito com outras SQL Server Native Client propriedades de definição de cursor do provedor OLE DB causa 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 L/G: Leitura/gravação

Padrão: VARIANT_FALSE

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

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB SQL Server Native Client expõe a interface ISupportErrorInfo em conjuntos de linhas.
DBPROP_ILockBytes Essa interface não é implementada pelo provedor OLE DB SQL Server Native Client. A tentativa de ler ou gravar a propriedade gera um erro.
DBPROP_ISequentialStream L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB SQL Server Native Client expõe a interface ISequentialStream para dar suporte a dados longos e de comprimento variável armazenados em SQL Server.
DBPROP_IStorage Essa interface não é implementada pelo provedor OLE DB SQL Server Native Client. A tentativa de ler ou gravar a propriedade gera um erro.
DBPROP_IStream Essa interface não é implementada pelo provedor OLE DB SQL Server Native Client. A tentativa de ler ou gravar a propriedade gera um erro.
DBPROP_IMMOBILEROWS L/G: Leitura/gravação

Padrão: VARIANT_TRUE

Descrição: a propriedade só é VARIANT_TRUE para cursores de conjunto de chaves do SQL Server e é 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 estiver 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 de 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 de 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 L/G: Somente leitura

Padrão: VARIANT_TRUE

Descrição: essa propriedade é sempre VARIANT_TRUE.
DBPROP_LOCKMODE L/G: 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). Nota: Ao usar instantâneo isolamento em uma transação, se um conjunto de linhas for aberto usando um conjunto de chaves ou cursor de servidor dinâmico e o modo de bloqueio estiver definido como DBPROPVAL_LM_SINGLEROW, ocorrerá um erro ao buscar uma linha se outra pessoa 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 L/G: Somente leitura

Padrão: 0

Descrição: o SQL Server Native Client provedor OLE DB não limita o número de linhas que podem estar ativas em conjuntos de linhas.
DBPROP_MAXPENDINGROWS L/G: Somente leitura

Padrão: 0

Descrição: o provedor OLE DB SQL Server Native Client não limita o número de linhas de conjunto de linhas com alterações pendentes.
DBPROP_MAXROWS L/G: Leitura/gravação

Padrão: 0

Descrição: por padrão, o provedor OLE DB 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 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 consequências não intencionais na execução de instrução do SQL Server. Para obter mais informações, confira SET ROWCOUNT.
DBPROP_MAYWRITECOLUMN Essa propriedade de conjunto de linhas não é implementada pelo provedor SQL Server Native Client OLE DB. A tentativa de ler ou gravar o valor da propriedade gera um erro.
DBPROP_MEMORYUSAGE Essa propriedade de conjunto de linhas não é implementada pelo provedor SQL Server Native Client OLE DB. A tentativa de ler ou gravar o valor da propriedade gera um erro.
DBPROP_NOTIFICATIONGRANULARITY Essa propriedade de conjunto de linhas não é implementada pelo provedor SQL Server Native Client OLE DB. A tentativa de ler ou gravar o valor da propriedade gera um erro.
DBPROP_NOTIFICATIONPHASES L/G: 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 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 L/G: Somente leitura

Padrão: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

Descrição: as fases de notificação do provedor OLE DB SQL Server Native Client são canceláveis antes de uma tentativa de executar a modificação do conjunto de linhas indicada. O provedor OLE DB SQL Server Native Client não dá suporte ao cancelamento de fase após a conclusão da tentativa.
DBPROP_ORDEREDBOOKMARKS Essa propriedade de conjunto de linhas não é implementada pelo provedor SQL Server Native Client OLE DB. A tentativa de ler ou gravar o valor da propriedade gera um erro.
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: definir propriedades de visibilidade de alteração faz com que o provedor OLE DB SQL Server Native Client use cursores SQL Server para dar suporte ao conjunto de linhas. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server.
DBPROP_QUICKRESTART L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: quando definido como VARIANT_TRUE, o provedor OLE DB SQL Server Native Client tenta usar um cursor de servidor para o conjunto de linhas.
DBPROP_REENTRANTEVENTS L/G: Somente leitura

Padrão: VARIANT_TRUE

Descrição: os conjuntos de linhas do provedor OLE DB SQL Server Native Client são reentrantes e podem retornar DB_E_NOTREENTRANT se um consumidor tentar acessar um método de conjunto de linhas não participante de um retorno de chamada de notificação.
DBPROP_REMOVEDELETED L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB SQL Server Native Client altera o valor da propriedade com base na visibilidade das alterações nos dados 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, confira 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 do fetch e é possível para os métodos de fetch 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 Essa propriedade de conjunto de linhas não é implementada pelo provedor SQL Server Native Client OLE DB. A tentativa de ler ou gravar o valor da propriedade gera um erro.
DBPROP_RETURNPENDINGINSERTS L/G: Somente leitura

Padrão: VARIANT_FALSE

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

Padrão: VARIANT_TRUE

Descrição: SQL Server Native Client conjuntos de linhas do provedor OLE DB não dão suporte a direitos de acesso com base 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 L/G: 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 compatível com SQL Server Native Client é DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL L/G: Somente leitura

Padrão: DBPROPVAL_RT_FREETHREAD

Descrição: o provedor OLE DB SQL Server Native Client dá suporte ao acesso a seus objetos de vários threads de execução de um único consumidor.
DBPROP_SERVERCURSOR L/G: 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, confira Conjuntos de linha e cursores do SQL Server.
DBPROP_SERVERDATAONINSERT L/G: 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 L/G: 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 for verdadeiro) e DBPROP_UPDATABILITY for definido 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 L/G: Somente leitura

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB SQL Server Native Client dá suporte apenas a objetos transacionados. Para obter mais informações, veja Transações.
DBPROP_UNIQUEROWS L/G: 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 pelos respectivos valores de coluna. As colunas de chave podem ou não ser sinalizadas com DBCOLUMNFLAGS_KEYCOLUMN.
DBPROP_UPDATABILITY L/G: Leitura/gravação

Padrão: 0

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte a todos os valores 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 SQL Server Native Client define o conjunto de propriedades específico do provedor DBPROPSET_SQLSERVERROWSET conforme mostrado nesta tabela.

ID da propriedade Descrição
SSPROP_COLUMN_ID Coluna: ColumnID

L/G: 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. Esse é o SQL Server Native Client provedor OLE DB equivalente ao atributo de SQL_CA_SS_COLUMN_ID ODBC.
SSPROP_DEFERPREPARE Coluna: Não

L/G: 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 é preparada quando ICommandPrepare::Prepare é executada.
SSPROP_IRowsetFastLoad Coluna: Não

L/G: Leitura/gravação

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

Descrição: defina essa propriedade como VARIANT_TRUE para abrir um conjunto de linhas de carga rápida por meio de IOpenRowset::OpenRowset. Não é possível definir essa propriedade em ICommandProperties::SetProperties.
SSPROP_ISSAsynchStatus Coluna: Não.

L/G: Leitura/gravação

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

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

L/G: 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 SQL Server Native Client executa uma instrução SET TEXTSIZE para restringir o comprimento dos dados de BLOB (objeto binário grande) retornados em uma instrução SELECT.
SSPROP_NOCOUNT_STATUS Coluna: NoCount

L/G: Somente leitura

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

Descrição: um valor booliano 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

L/G: 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

L/G: 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 é:

service=<service-name>[;(local database=<database>&#124;broker instance=<broker instance>)]

Por exemplo:

service=mySSBService;local database=mydb
SSPROP_QP_NOTIFICATION_TIMEOUT Coluna: Não

L/G: 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.

Consulte Também

Conjuntos de linhas