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 R/W: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o comportamento de um conjunto de linhas após uma operação de anulação é determinado por essa 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 rowset está quase perdida. Ele dá suporte apenas a operações IUnknown e à 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 R/W: leitura/gravação

Padrão: DBPROPVAL_AO_RANDOM

Descrição: Ordem de acesso. Ordem na qual as colunas devem ser acessadas no conjunto de linhas.

DBPROPVAL_AO_RANDOM: a coluna pode ser acessada em qualquer ordem.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: colunas associadas como objetos de armazenamento só podem ser acessadas em ordem sequencial determinada pelo ordinal de coluna.

DBPROPVAL_AO_SEQUENTIAL: todas as colunas devem ser acessadas em ordem sequencial determinada por ordinal de coluna.
DBPROP_APPENDONLY Essa propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. Tentar ler ou gravar o valor da propriedade gera um erro.
DBPROP_BLOCKINGSTORAGEOBJECTS R/W: somente leitura

Padrão: VARIANT_TRUE

Descrição: os objetos de armazenamento do provedor OLE DB do SQL Server Native Client bloqueiam o uso de outros métodos de conjunto de linhas.
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS R/W: 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.

Definir uma propriedade para VARIANT_TRUE não habilita o posicionamento do conjunto de linhas por indicador. Defina DBPROP_IRowsetLocate ou DBPROP_IRowsetScroll para VARIANT_TRUE para criar um conjunto de linhas com 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, consulte Conjuntos de linhas e cursores do SQL Server. Nota: 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, definir o 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 R/W: somente leitura

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client retorna DB_E_BADBOOKMARK se o consumidor indicar um indicador inválido ao posicionar ou pesquisar um conjunto de linhas com indicadores.
DBPROP_BOOKMARKTYPE R/W: 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, digite DBTYPE_UI4.
DBPROP_CACHEDEFERRED Essa propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. Tentar ler ou gravar o valor da propriedade gera um erro.
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS R/W: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte à busca e rolagem com versões anteriores em conjuntos de linhas não sequenciais. O provedor OLE DB do SQL Server Native Client cria um conjunto de linhas com suporte para cursor quando DBPROP_CANFETCHBACKWARDS ou DBPROP_CANSCROLLBACKWARDS é VARIANT_TRUE. Para obter mais informações, consulte Conjuntos de linhas e cursores do SQL Server.
DBPROP_CANHOLDROWS R/W: 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 há alterações pendentes naqueles atualmente no conjunto de linhas. Esse comportamento pode ser modificado.

Definir DBPROP_CANHOLDROWS e DBPROP_IRowsetChange como VARIANT_TRUE implica um conjunto de linhas com indicadores. Se ambas as 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 são compatíveis com cursores do SQL Server.
DBPROP_CHANGEINSERTEDROWS R/W: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: essa propriedade só pode ser definida como VARIANT_TRUE se o conjunto de linhas estiver usando um cursor controlado por conjunto de chaves.
DBPROP_COLUMNRESTRICT R/W: 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 próprias linhas 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, o dwFlags exibe DBCOLUMNFLAGS_WRITE.
DBPROP_COMMANDTIMEOUT R/W: leitura/gravação

Padrão: 0

Descrição: por padrão, o provedor OLE DB do SQL Server Native Client não atingiu o tempo limite no método ICommand::Execute .
DBPROP_COMMITPRESERVE R/W: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: o comportamento de um conjunto de linhas após uma operação de confirmação é determinado por essa 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 rowset está quase perdida. Ele dá suporte apenas a operações IUnknown e à versão de identificadores de linha e acessador pendentes.
DBPROP_DEFERRED R/W: 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 de texto, ntext e imagem não são retornadas do servidor até que sejam acessadas pelo aplicativo.
DBPROP_DELAYSTORAGEOBJECTS R/W: 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 nos dados em um objeto de fluxo sequencial são enviadas imediatamente ao SQL Server. As modificações são confirmadas com base no modo de transação do conjunto de linhas.
DBPROP_HIDDENCOLUMNS R/W: 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 adicionadas pelo provedor para identificar exclusivamente as linhas dentro do conjunto de linhas. Essas colunas são retornadas por IColumnsInfo::GetColumnInfo e IColumnsRowset::GetColumnsRowset. No entanto, eles não são incluídos 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 R/W: 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 R/W: leitura/gravação

Padrão: VARIANT_TRUE

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte à interface IColumnsRowset .
DBPROP_IConnectionPointContainer R/W: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: IConnectionPointContainer. Se VARIANT_TRUE, o conjunto de linhas oferecerá suporte à interface especificada. Se VARIANT_FALSE, o conjunto de linhas não oferecerá suporte à interface especificada. Os provedores que dão suporte a uma interface devem dar suporte à propriedade associada a essa interface com um valor de VARIANT_TRUE. Essas propriedades são usadas principalmente para solicitar interfaces por meio de ICommandProperties::SetProperties.
DBPROP_IMultipleResults R/W: 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 R/W: 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 imediatos de modo de atualização.

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

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 linhas e cursores do SQL Server.
DBPROP_IRowsetIdentity R/W: 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 a essa interface, os dois identificadores de linha que representam a mesma linha subjacente sempre refletirão 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 R/W: 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.

Indicadores são necessários para qualquer interface. O provedor OLE DB do SQL Server Native Client define DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS para 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 linhas 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, definir 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 R/W: 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 - Suporte a Informações de Erro R/W: 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. Tentar ler ou gravar a propriedade gera um erro.
DBPROP_ISequentialStream R/W: 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 longos armazenados no SQL Server.
DBPROP_IStorage Essa interface não é implementada pelo provedor OLE DB do SQL Server Native Client. Tentar ler ou gravar a propriedade gera um erro.
DBPROP_IStream Essa interface não é implementada pelo provedor OLE DB do SQL Server Native Client. Tentar ler ou gravar a propriedade gera um erro.
DBPROP_IMMOBILEROWS R/W: leitura/gravação

Padrão: VARIANT_TRUE

Descrição: a propriedade é apenas 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 reordenará as linhas inseridas ou atualizadas. Para IRowsetChange::InsertRow, as linhas serão exibidas no final 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 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 (normalmente um conjunto de linhas para o qual DBPROP_OTHERUPDATEDELETE é VARIANT_TRUE mas DBPROP_OTHERINSERT é VARIANT_FALSE), alterar o valor de uma coluna de chave geralmente será equivalente a excluir a linha atual e inserir uma nova. Portanto, a linha pode parecer mover ou até mesmo desaparecer do conjunto de linhas, se DBPROP_OWNINSERT for VARIANT_FALSE, mesmo que a propriedade DBPROP_IMMOBILEROWS seja VARIANT_TRUE.

VARIANT_FALSE: se o conjunto de linhas for ordenado, as linhas inseridas aparecerão na ordem correta do conjunto de linhas. Se o conjunto de linhas não for ordenado, a linha inserida será exibida no final. Se IRowsetChange::SetData alterar uma coluna 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 R/W: somente leitura

Padrão: VARIANT_TRUE

Descrição: essa propriedade é sempre VARIANT_TRUE.
DBPROP_LOCKMODE R/W: 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 o isolamento de 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 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 outra pessoa tiver atualizado a linha desde que a transação foi iniciada, um erro não ocorrerá até que o usuário tente atualizar a linha. Em ambos os casos, esses erros são gerados pelo servidor.
DBPROP_MAXOPENROWS R/W: 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 R/W: somente leitura

Padrão: 0

Descrição: o provedor OLE DB do SQL Server Native Client não limita o número de linhas de conjunto de linhas com alterações pendentes.
DBPROP_MAXROWS R/W: 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 da instrução do SQL Server. Para obter mais informações, consulte SET ROWCOUNT.
DBPROP_MAYWRITECOLUMN Essa propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. Tentar 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. Tentar 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. Tentar ler ou gravar o valor da propriedade gera um erro.
DBPROP_NOTIFICATIONPHASES R/W: 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 R/W: 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 são canceláveis 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. Tentar ler ou gravar o valor da propriedade gera um erro.
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE R/W: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: definir 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, consulte Conjuntos de linhas e cursores do SQL Server.
DBPROP_QUICKRESTART R/W: 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 (Eventos Reentrantes de DBPROP) R/W: somente leitura

Padrão: VARIANT_TRUE

Descrição: os conjuntos de linhas do provedor OLE DB do SQL Server Native Client são re-participantes 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 R/W: 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 por outros usuários do SQL Server são removidas do conjunto de linhas quando o conjunto de linhas é atualizado. DBPROP_OTHERINSERT é VARIANT_TRUE.

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

Essa propriedade só tem valor para conjuntos de linhas compatíveis com cursores do SQL Server. Para obter mais informações, consulte Conjuntos de linhas e cursores do SQL Server.

Quando a propriedade DBPROP_REMOVEDELETED é implementada em um conjunto de linhas de cursor de conjunto de chaves, as linhas excluídas são removidas no tempo de busca e é possível que métodos de busca de linha, como GetNextRows e GetRowsAt, retornem S_OK e menos linhas do que o solicitado. Observe que esse comportamento não significa a condição DB_S_ENDOFROWSET e que o número de linhas retornadas nunca será zero se houver linhas restantes.
DBPROP_REPORTMULTIPLECHANGES Essa propriedade de conjunto de linhas não é implementada pelo provedor OLE DB do SQL Server Native Client. Tentar ler ou gravar o valor da propriedade gera um erro.
DBPROP_RETURNPENDINGINSERTS R/W: 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 R/W: 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 R/W: leitura/gravação

Padrão: 0

Descrição: fornece para processamento de conjunto de linhas qualquer. Essa propriedade está no grupo de propriedades Rowset e DBPROPSET_ROWSET conjunto de propriedades. O tipo é VT_14.

O único valor na máscara de bits compatível com o SQL Server Native Client é DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL R/W: 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 a partir de vários threads de execução de um único consumidor.
DBPROP_SERVERCURSOR R/W: leitura/gravação

Padrão: VARIANT_FALSE

Descrição: quando definido, um cursor do SQL Server é usado para dar suporte ao conjunto de linhas. Para obter mais informações, consulte Conjuntos de linhas e cursores do SQL Server.
DBPROP_SERVERDATAONINSERT R/W: leitura/gravação

Padrão: VARIANT_FALSE

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

VARIANT_TRUE: no momento em que uma inserção é transmitida para o 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 recém-inseridas.
DBPROP_STRONGIDENTITY R/W: somente leitura

Padrão: VARIANT_TRUE

Descrição: identidade de linha forte. Se as inserções forem permitidas em um conjunto de linhas ( IRowsetChange ou IRowsetUpdate for true) e DBPROP_UPDATABILITY for definida para dar suporte a InsertRows, o valor de DBPROP_STRONGIDENTITY dependerá de DBPROP_CHANGEINSERTEDROWS propriedade (será VARIANT_FALSE se DBPROP_CHANGEINSERTEDROWS valor da propriedade for VARIANT_FALSE).
DBPROP_TRANSACTEDOBJECT R/W: 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, consulte Transações.
DBPROP_UNIQUEROWS R/W: 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 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 R/W: leitura/gravação

Padrão: 0

Descrição: o provedor OLE DB do SQL Server Native Client dá suporte a todos os valores de DBPROP_UPDATABILITY. Definir 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 conforme mostrado nesta tabela.

ID da Propriedade Descrição
SSPROP_COLUMN_ID Coluna: ColumnID

R/W: somente leitura

Tipo: VT_U12 | VT_ARRAY

Padrão: VT_EMPTY

Descrição: uma matriz de valores inteiros que representam a posição ordinal (baseada em 1) de uma coluna de resultado da cláusula COMPUTE dentro da instrução SELECT Transact-SQL atual. Esse é o provedor OLE DB do SQL Server Native Client equivalente ao atributo ODBC SQL_CA_SS_COLUMN_ID.
SSPROP_DEFERPREPARE Coluna: Não

R/W: leitura/gravação

Tipo: VT_BOOL

Padrão: VARIANT_TRUE

Descrição: VARIANT_TRUE: na execução preparada, a preparação do comando é adiada até que ICommand::Execute seja chamado ou uma operação de metapropertia seja executada. Se a propriedade estiver definida como

VARIANT_FALSE: a instrução é preparada quando ICommandPrepare::P repare é executado.
SSPROP_IRowsetFastLoad Coluna: Não

R/W: 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 carregamento rápido por meio de IOpenRowset::OpenRowset. Não é possível definir essa propriedade em ICommandProperties::SetProperties.
SSPROP_ISSAsynchStatus Coluna: Não.

R/W: leitura/gravação

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

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

R/W: 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 o 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

R/W: 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

R/W: leitura/gravação

Tipo: VT_BSTR (1-2000 caracteres permitidos)

Padrão: cadeia de caracteres vazia

Descrição: o texto da mensagem da notificação de consulta. Isso é definido pelo usuário e não tem um formato definido.
SSPROP_QP_NOTIFICATION_OPTIONS Coluna: Não

R/W: leitura/gravação

Tipo: VT_BSTR

Padrão: cadeia de caracteres vazia

Descrição: as opções de notificação de consulta. Eles são especificados 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

R/W: leitura/gravação

Tipo: VT_UI4

Padrão: 432000 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 deve permanecer ativa.

Consulte Também

Conjuntos de linhas