Propriedades e comportamentos do conjunto de linhas (provedor OLE DB do Native Client)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

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

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

Observação: Definir essas propriedades em conflito com outras propriedades de definição de cursor do provedor OLE DB do SQL Server Native Client 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 do SQL Server Native Client retornará DB_E_BADBOOKMARK se o consumidor indicar um indicador inválido ao posicionar ou pesquisar um conjunto de linhas marcado.
DBPROP_BOOKMARKTYPE L/G: 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 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 para trás em conjuntos de linhas não sequenciais. 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, 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 do SQL Server Native Client retorna DB_E_ROWSNOTRELEASED se o consumidor tentar obter mais linhas para um conjunto de linhas enquanto houver alterações pendentes naqueles que estão 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.

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 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 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 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 do SQL Server Native Client não atinge 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 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 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 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 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 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, 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 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 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, confira Conjuntos de linha e cursores do SQL Server.

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

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB do SQL Server Native Client expõe a interface ISupportErrorInfo em conjuntos de linhas.
DBPROP_ILockBytes Essa 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 L/G: 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 longos e de comprimento variável armazenados no SQL Server.
DBPROP_IStorage Essa 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 Essa 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 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).

Observaçã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 o fetch de uma linha se outro usuário tiver atualizado essa linha desde o início da transação. 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 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 L/G: 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 L/G: 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 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 OLE DB do SQL Server Native Client. 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 OLE DB do SQL Server Native Client. 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 OLE DB do SQL Server Native Client. 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 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 L/G: 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 de executar a modificação do 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 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_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: a configuração de propriedades de visibilidade de alteração 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, 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 do 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 do 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 reentrante 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 do SQL Server Native Client altera o valor da propriedade com base na visibilidade das alterações 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, 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 OLE DB do SQL Server Native Client. 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 OLE DB do SQL Server Native Client não retorna linhas de inserção pendentes.
DBPROP_ROWRESTRICT L/G: 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 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 assíncrono de conjunto de linhas. 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 com suporte do SQL Server Native Client é DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL L/G: Somente leitura

Padrão: DBPROPVAL_RT_FREETHREAD

Descrição: o provedor OLE DB do 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 do 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 do SQL Server Native Client define o conjunto de propriedades específicas 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 equivalente do provedor OLE DB do SQL Server Native Client ao atributo 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 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

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