Partilhar via


Propriedades e Comportamentos do Rowset

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Base de dados SQL no Microsoft Fabric

Baixar driver OLE DB

A seguir estão as propriedades do Driver OLE DB para o conjunto de linhas do SQL Server:

ID da Propriedade Description
DBPROP_ABORTPRESERVE R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O comportamento de um conjunto de linhas após uma operação de abortar é determinado por esta propriedade.

VARIANT_FALSE: O Driver OLE DB para SQL Server invalida os conjuntos de linhas após uma operação de aborto. A funcionalidade do objeto rowset está quase perdida. Suporta apenas operações IUnknown e a libertação de linhas e alavancas de acesso pendentes.

VARIANT_TRUE: O Driver OLE DB para SQL Server mantém um conjunto de linhas válido.
DBPROP_ACCESSORDER R/W: Ler/Escrever

Padrão: DBPROPVAL_AO_RANDOM

Descrição: Ordem de acesso. Ordem em que as colunas devem ser acedidas no conjunto de linhas.

DBPROPVAL_AO_RANDOM: A coluna pode ser acedida em qualquer ordem.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: Colunas limitadas como objetos de armazenamento só podem ser acedidas em ordem sequencial determinada pelo ordinal da coluna.

DBPROPVAL_AO_SEQUENTIAL: Todas as colunas devem ser acedidas por ordem sequencial, determinada pelo ordinal da coluna.
DBPROP_APPENDONLY Esta propriedade de conjunto de linhas não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever o valor da propriedade gera um erro.
DBPROP_BLOCKINGSTORAGEOBJECTS R/W: Só leitura

Padrão: VARIANT_TRUE

Descrição: O Driver OLE DB para objetos de armazenamento SQL Server bloqueia usando outros métodos de conjunto de linhas.
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server suporta favoritos para identificação de linhas de linhas quando DBPROP_BOOKMARKS ou DBPROP_LITERALBOOKMARKS está VARIANT_TRUE.

Definir qualquer uma das propriedades para VARIANT_TRUE não permite o posicionamento do conjunto de linhas por favorito. Defina DBPROP_IRowsetLocate ou DBPROP_IRowsetScroll para VARIANT_TRUE para criar um conjunto de linhas que suporte o posicionamento do conjunto de linhas por marcador de favoritos.

O Driver OLE DB para SQL Server utiliza um cursor Microsoft SQL Server para suportar um conjunto de linhas que contém favoritos. Para mais informações, consulte Rowsets e SQL Server Cursors.

Nota: Definir estas propriedades em conflito com outros drivers OLE DB para propriedades que definem o cursor do SQL Server causa um erro. Por exemplo, definir o DBPROP_BOOKMARKS para VARIANT_TRUE quando DBPROP_OTHERINSERT também está VARIANT_TRUE gera um erro quando o consumidor tenta abrir um conjunto de linhas.
DBPROP_BOOKMARKSKIPPED R/W: Só leitura

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server devolve DB_E_BADBOOKMARK se o consumidor indicar um marcador inválido ao posicionar ou pesquisar um conjunto de linhas marcado.
DBPROP_BOOKMARKTYPE R/W: Só leitura

Padrão: DBPROPVAL_BMK_NUMERIC

Descrição: O Driver OLE DB para SQL Server implementa apenas marcadores numéricos. Um marcador de um controlador OLE DB para SQL Server é um inteiro não assinado de 32 bits, tipo DBTYPE_UI4.
DBPROP_CACHEDEFERRED Esta propriedade de conjunto de linhas não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever o valor da propriedade gera um erro.
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server suporta busca retrocessa e scroll em conjuntos de linhas não sequenciais. O Driver OLE DB para SQL Server cria um conjunto de linhas suportado por cursor quando DBPROP_CANFETCHBACKWARDS ou DBPROP_CANSCROLLBACKWARDS está VARIANT_TRUE. Para mais informações, consulte Rowsets e SQL Server Cursors.
DBPROP_CANHOLDROWS R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: Por defeito, o Driver OLE DB para SQL Server devolve DB_E_ROWSNOTRELEASED se o consumidor tentar obter mais linhas para um conjunto de linhas enquanto existem alterações pendentes nas linhas atualmente no conjunto. Este comportamento pode ser modificado.

Definir tanto DBPROP_CANHOLDROWS como DBPROP_IRowsetChange para VARIANT_TRUE implica um conjunto de linhas com favoritos. Se ambas as propriedades estiverem VARIANT_TRUE, a interface IRowsetLocate está disponível no conjunto de linhas e DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS são ambos VARIANT_TRUE.

O Driver OLE DB para conjuntos de linhas SQL Server que contêm favoritos é suportado por cursores SQL Server.
DBPROP_CHANGEINSERTEDROWS R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: Esta propriedade só pode ser definida para VARIANT_TRUE se o conjunto de linhas estiver a usar um cursor controlado por keyset.
DBPROP_COLUMNRESTRICT R/W: Só leitura

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server define a propriedade para VARIANT_TRUE quando uma coluna num conjunto de linhas não pode ser alterada pelo consumidor. Outras colunas do conjunto de linhas podem ser atualizáveis e as próprias linhas podem ser eliminadas.

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 escrito ou não. Para colunas modificáveis, dwFlags exibe DBCOLUMNFLAGS_WRITE.
DBPROP_COMMANDTIMEOUT R/W: Ler/Escrever

Padrão: 0

Descrição: Por defeito, o driver OLE DB para SQL Server não expira no método ICommand::Execut .
DBPROP_COMMITPRESERVE R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O comportamento de um conjunto de linhas após uma operação de commit é determinado por esta propriedade.

VARIANT_TRUE: O Driver OLE DB para SQL Server mantém um conjunto de linhas válido.

VARIANT_FALSE: O Driver OLE DB para SQL Server invalida os conjuntos de linhas após uma operação de commit. A funcionalidade do objeto rowset está quase perdida. Suporta apenas operações IUnknown e a libertação de linhas e alavancas de acesso pendentes.
DBPROP_DEFERRED R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: Quando definido para VARIANT_TRUE o Driver OLE DB para SQL Server tenta usar um cursor de servidor para o conjunto de linhas. Texto, ntext e colunas de imagem não são devolvidas pelo servidor até serem acedidas pela aplicação.
DBPROP_DELAYSTORAGEOBJECTS R/W: Só leitura

Padrão: VARIANT_FALSE

Descrição: O OLE DB Driver para SQL Server suporta modo de atualização imediata em objetos de armazenamento.

As alterações feitas aos dados num objeto de fluxo sequencial são imediatamente submetidas ao SQL Server. As modificações são realizadas com base no modo de transação por conjuntos de linhas.
DBPROP_HIDDENCOLUMNS R/W: Só leitura

Padrão: VARIANT_FALSE

Descrição: Contagem de Colunas Ocultas

Se DBPROP_UNIQUEROWS for VARIANT_TRUE, a propriedade DBPROP_HIDDENCOLUMNS devolve o número de colunas adicionais "ocultas" adicionadas pelo fornecedor para identificar de forma única as linhas dentro do conjunto de linhas. Estas colunas são devolvidas por IColumnsInfo::GetColumnInfo e IColumnsRowset::GetColumnsRowset. No entanto, não são incluídas na contagem de linhas devolvidas pelo argumento pcColumns devolvido por IColumnsInfo::GetColumnInfo.

Para determinar o número total de colunas representadas na estrutura prgInfo devolvida por IColumnsInfo::GetColumnInfo, incluindo colunas ocultas, o consumidor adiciona o valor de DBPROP_HIDDENCOLUMNS à contagem de colunas devolvidas de IColumnsInfo::GetColumnInfo em pcColumns. Se DBPROP_UNIQUEROWS for VARIANT_FALSE, DBPROP_HIDDENCOLUMNS é zero.
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo R/W: Só leitura

Padrão: VARIANT_TRUE

Descrição: O Driver OLE DB para SQL Server suporta estas interfaces em todos os conjuntos de linhas.
DBPROP_IColumnsRowset R/W: Ler/Escrever

Padrão: VARIANT_TRUE

Descrição: O Driver OLE DB para SQL Server suporta a interface IColumnsRowset .
DBPROP_IConnectionPointContainer R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: IConnectionPointContainer. Se VARIANT_TRUE, o conjunto de linhas suporta a interface especificada. Se VARIANT_FALSE, o conjunto de linhas não suporta a interface especificada. Os fornecedores que suportam uma interface devem suportar a propriedade associada a essa interface com um valor de VARIANT_TRUE. Estas propriedades são principalmente usadas para solicitar interfaces através do ICommandProperties::SetProperties.
DBPROP_IMultipleResults R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server suporta a interface IMultipleResults .
DBPROP_IRowsetChange DBPROP_IRowsetUpdate R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server suporta as interfaces IRowsetChange e IRowsetUpdate .

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

Quando DBPROP_IRowsetUpdate é VARIANT_TRUE, DBPROP_IRowsetChange também é VARIANT_TRUE. O conjunto de linhas apresenta um comportamento retardado no modo de atualização.

O Driver OLE DB para SQL Server utiliza um cursor SQL Server para suportar conjuntos de linhas que expõem IRowsetChange ou IRowsetUpdate. Para mais informações, consulte Rowsets e SQL Server Cursors.
DBPROP_IRowsetIdentity R/W: Ler/Escrever

Padrão: VARIANT_TRUE

Descrição: O Driver OLE DB para SQL Server suporta a interface IRowsetIdentity . Se um conjunto de linhas suportar esta interface, quaisquer dois handles de linha que representem a mesma linha subjacente refletirão sempre os mesmos dados e estado. Os consumidores podem chamar o método IRowsetIdentity:: IsSameRow para comparar dois handles de linha e ver se se referem à mesma instância de linha.
DBPROP_IRowsetLocate DBPROP_IRowsetScroll R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server 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.

Os marcadores são necessários para qualquer interface. O Driver OLE DB para SQL Server define DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS para VARIANT_TRUE quando o consumidor solicita qualquer uma das interfaces.

O Driver OLE DB para SQL Server utiliza cursores SQL Server para suportar IRowsetLocate e IRowsetScroll. Para mais informações, consulte Rowsets e SQL Server Cursors.

Definir estas propriedades em conflito com outros drivers OLE DB para propriedades que definem o cursor do SQL Server causa um erro. Por exemplo, definir DBPROP_IRowsetScroll para VARIANT_TRUE quando DBPROP_OTHERINSERT também está VARIANT_TRUE gera um erro quando o consumidor tenta abrir um conjunto de linhas.
DBPROP_IRowsetResynch R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server expõe a interface IRowsetResynch sob demanda. O Driver OLE DB para SQL Server pode expor a interface em qualquer conjunto de linhas.
DBPROP_ISupportErrorInfo R/W: Ler/Escrever

Padrão: VARIANT_TRUE

Descrição: O Driver OLE DB para SQL Server expõe a interface ISupportErrorInfo em conjuntos de linhas.
DBPROP_ILockBytes Esta interface não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever a propriedade gera um erro.
DBPROP_ISequentialStream R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server expõe a interface ISequentialStream para suportar dados longos e de comprimento variável armazenados no SQL Server.
DBPROP_IStorage Esta interface não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever a propriedade gera um erro.
DBPROP_IStream Esta interface não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever a propriedade gera um erro.
DBPROP_IMMOBILEROWS R/W: Ler/Escrever

Padrão: VARIANT_TRUE

Descrição: A propriedade é VARIANT_TRUE apenas para cursores de keyset SQL Server; É VARIANT_FALSE para todos os outros cursores.

VARIANT_TRUE: O conjunto de linhas não reordena as linhas inseridas ou atualizadas. Para IRowsetChange::InsertRow, as linhas aparecerão 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 é 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 é movida. Se o conjunto de linhas for construído sobre um conjunto de colunas de chave (tipicamente 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 equivalente a eliminar a linha atual e inserir uma nova. Assim, a linha pode parecer mover-se ou até 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 estiver ordenado, as linhas inseridas aparecem na ordem correta do conjunto. Se o conjunto de linhas não estiver ordenado, a linha inserida aparece no final. Se IRowsetChange::SetData alterar uma coluna usada para ordenar o conjunto de linhas, a linha é movida. Se o conjunto de linhas não estiver ordenado, a posição da linha não é alterada.
DBPROP_LITERALIDENTITY R/W: Só leitura

Padrão: VARIANT_TRUE

Descrição: Esta propriedade é sempre VARIANT_TRUE.
DBPROP_LOCKMODE R/W: Ler/Escrever

Padrão: DBPROPVAL_LM_NONE

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

Nota: Ao usar isolamento de instantâneos numa transação, se um conjunto de linhas for aberto usando um keyset ou cursor de servidor dinâmico e o modo de bloqueio estiver definido para DBPROPVAL_LM_SINGLEROW, ocorrerá um erro ao buscar uma linha se alguém tiver atualizado essa linha desde o início da transação. Para outros tipos de cursor e modos de bloqueio, se outra pessoa atualizou a linha desde o início da transação, o erro não ocorre até que o utilizador tente atualizar a linha. Em ambos os casos, estes erros são gerados pelo servidor.
DBPROP_MAXOPENROWS R/W: Só leitura

Padrão: 0

Descrição: O Driver OLE DB para SQL Server não limita o número de linhas que podem estar ativas em conjuntos de linhas.
DBPROP_MAXPENDINGROWS R/W: Só leitura

Padrão: 0

Descrição: O Driver OLE DB para SQL Server não limita o número de linhas de linhas com alterações pendentes.
DBPROP_MAXROWS R/W: Ler/Escrever

Padrão: 0

Descrição: Por defeito, o Driver OLE DB para SQL Server não limita o número de linhas num conjunto de linhas. Quando o consumidor define DBPROP_MAXROWS, o Driver OLE DB para SQL Server utiliza 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ções SQL Server. Para mais informações, consulte SET ROWCOUNT.
DBPROP_MAYWRITECOLUMN Esta propriedade de conjunto de linhas não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever o valor da propriedade gera um erro.
DBPROP_MEMORYUSAGE Esta propriedade de conjunto de linhas não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever o valor da propriedade gera um erro.
DBPROP_NOTIFICATIONGRANULARITY Esta propriedade de conjunto de linhas não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever o valor da propriedade gera um erro.
DBPROP_NOTIFICATIONPHASES R/W: Só leitura

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

Descrição: O Driver OLE DB para SQL Server suporta 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: Só leitura

Padrão: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

Descrição: O Driver OLE DB para as fases de notificação do SQL Server pode ser cancelado antes de uma tentativa de realizar a modificação do conjunto de linhas indicada. O Driver OLE DB para SQL Server não suporta cancelamento de fase após a conclusão da tentativa.
DBPROP_ORDEREDBOOKMARKS Esta propriedade de conjunto de linhas não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever o valor da propriedade gera um erro.
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: Definir as propriedades de visibilidade de alteração faz com que o Driver OLE DB para SQL Server use cursores SQL Server para suportar o conjunto de linhas. Para mais informações, consulte Rowsets e SQL Server Cursors.
DBPROP_QUICKRESTART R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: Quando definido para VARIANT_TRUE, o Driver OLE DB para SQL Server tenta usar um cursor de servidor para o conjunto de linhas.
DBPROP_REENTRANTEVENTS R/W: Só leitura

Padrão: VARIANT_TRUE

Descrição: O Driver OLE DB para conjuntos de linhas SQL Server são reentrantes e podem devolver DB_E_NOTREENTRANT se um consumidor tentar aceder a um método de rowset não reentrante a partir de um callback de notificação.
DBPROP_REMOVEDELETED R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server altera o valor da propriedade com base na visibilidade das alterações aos dados do SQL Server expostas pelo conjunto de linhas.

VARIANT_TRUE: Linhas eliminadas pelo consumidor ou por outros utilizadores do SQL Server são removidas do conjunto de linhas quando este é atualizado. DBPROP_OTHERINSERT é VARIANT_TRUE.

VARIANT_FALSE: As linhas eliminadas pelo consumidor ou por outros utilizadores do SQL Server não são removidas do conjunto de linhas quando este é atualizado. O valor de estado da linha para linhas eliminadas do SQL Server no conjunto de linhas é DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT é VARIANT_TRUE.

Esta propriedade só tem valor para conjuntos de linhas suportados por cursores do SQL Server. Para mais informações, consulte Rowsets e SQL Server Cursors.

Quando a propriedade DBPROP_REMOVEDELETED é implementada num conjunto de linhas com cursor de keyset, as linhas eliminadas são removidas em tempo de busca e é possível que métodos de busca de linhas, como GetNextRows e GetRowsAt, devolvam tanto S_OK como menos linhas do que as solicitadas. Note-se que este comportamento não significa a condição de DB_S_ENDOFROWSET e que o número de linhas devolvidas nunca será zero se houver linhas restantes.
DBPROP_REPORTMULTIPLECHANGES Esta propriedade de conjunto de linhas não é implementada pelo Driver OLE DB para SQL Server. Tentar ler ou escrever o valor da propriedade gera um erro.
DBPROP_RETURNPENDINGINSERTS R/W: Só leitura

Padrão: VARIANT_FALSE

Descrição: Quando um método que obtém linhas é chamado, o Driver OLE DB para SQL Server não devolve linhas de inserção pendentes.
DBPROP_ROWRESTRICT R/W: Só leitura

Padrão: VARIANT_TRUE

Descrição: O Driver OLE DB para conjuntos de linhas SQL Server não suporta direitos de acesso baseados na linha. Se a interface IRowsetChange for exposta num conjunto de linhas, o método SetData pode ser chamado pelo consumidor.
DBPROP_ROWSET_ASYNCH R/W: Ler/Escrever

Padrão: 0

Descrição: Permite o processamento assíncrono de conjuntos de linhas. Esta propriedade pertence ao grupo de propriedades Rowset e DBPROPSET_ROWSET conjunto de propriedades. O tipo é VT_14.

O único valor na máscara de bits suportado pelo OLE DB Driver para SQL Server é DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL R/W: Só leitura

Padrão: DBPROPVAL_RT_FREETHREAD

Descrição: O Driver OLE DB para SQL Server suporta o acesso aos seus objetos a partir de múltiplos threads de execução de um único consumidor.
DBPROP_SERVERCURSOR R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: Quando definido, um cursor SQL Server é usado para suportar o conjunto de linhas. Para mais informações, consulte Rowsets e SQL Server Cursors.
DBPROP_SERVERDATAONINSERT R/W: Ler/Escrever

Padrão: VARIANT_FALSE

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

VARIANT_TRUE: No momento em que um inserto é transmitido para o servidor, o fornecedor recupera dados do servidor para atualizar a linha cache local.

VARIANT_FALSE: O fornecedor não recupera valores do servidor para linhas recém-inseridas.
DBPROP_STRONGIDENTITY R/W: Só leitura

Padrão: VARIANT_TRUE

Descrição: Forte identidade de fila. Se os inserts forem permitidos num conjunto de linhas ( IRowsetChange ou IRowsetUpdate é verdadeiro), e DBPROP_UPDATABILITY estiver definido para suportar InsertRows, o valor de DBPROP_STRONGIDENTITY depende de DBPROP_CHANGEINSERTEDROWS propriedade (será VARIANT_FALSE se DBPROP_CHANGEINSERTEDROWS valor for VARIANT_FALSE).
DBPROP_TRANSACTEDOBJECT R/W: Só leitura

Padrão: VARIANT_FALSE

Descrição: O Driver OLE DB para SQL Server suporta apenas objetos transacionados. Para mais informações, consulte Transações.
DBPROP_UNIQUEROWS R/W: Ler/Escrever

Padrão: VARIANT_FALSE

Descrição: Linhas únicas.

VARIANT_TRUE: Cada linha é identificada de forma única pelos seus valores de coluna. O conjunto de colunas que identificam de forma única a linha tem o DBCOLUMNFLAGS_KEYCOLUMN definido na estrutura DBCOLUMNINFO devolvida do método GetColumnInfo .

VARIANT_FALSE: As linhas podem ou não ser identificadas de forma única pelos seus valores de coluna. As colunas-chave podem ou não estar sinalizadas com DBCOLUMNFLAGS_KEYCOLUMN.
DBPROP_UPDATABILITY R/W: Ler/Escrever

Padrão: 0

Descrição: O Driver OLE DB para SQL Server suporta todos os valores 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 Driver OLE DB para SQL Server define o conjunto de propriedades específico do fornecedor DBPROPSET_SQLSERVERROWSET conforme mostrado nesta tabela.

ID da Propriedade Description
SSPROP_COLUMN_ID Coluna: ColumnID

R/W: Só leitura

Tipo: VT_U12 | VT_ARRAY

Padrão: VT_EMPTY

Descrição: Um array de valores inteiros que representa a posição ordinal (baseada em 1) de uma coluna de resultado de uma cláusula COMPUTE dentro da instrução SELECT Transact-SQL atual. Este é o equivalente do ODBC SQL_CA_SS_COLUMN_ID ao ODBC Driver para SQL Server.
SSPROP_DEFERPREPARE Coluna: Não

R/W: Ler/Escrever

Tipo: VT_BOOL

Padrão: VARIANT_TRUE

Descrição: VARIANT_TRUE: Na execução preparada, a preparação do comando é adiada até que o ICommand::Execute seja chamado ou seja realizada uma operação de metapropriedade. Se a propriedade for definida como

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

R/W: Ler/Escrever

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

Descrição: Defina esta propriedade para VARIANT_TRUE para abrir um conjunto de linhas de carregamento rápido através do IOpenRowset::OpenRowset. Não pode definir esta propriedade em ICommandProperties::SetProperties.
SSPROP_ISSAsynchStatus Coluna: Não.

R/W: Ler/Escrever

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

Descrição: Defina esta propriedade para VARIANT_TRUE para permitir operações assíncronas usando a interface ISSAsynchStatus .
SSPROP_ISSDataClassification R/W: Ler/Escrever

Tipo: VT_BOOL

Padrão: VARIANT_TRUE

Descrição: O Driver OLE DB para SQL Server suporta a recuperação de informação de classificação de sensibilidade utilizando a interface ISSDataClassification .
SSPROP_MAXBLOBLENGTH Coluna: Não

R/W: Ler/Escrever

Tipo: VT_I4

Padrão: O fornecedor não restringe o tamanho do texto devolvido pelo servidor e o valor da propriedade é definido no máximo. Por exemplo, 2147483647.

Descrição: O Driver OLE DB para SQL Server executa uma instrução SET TEXTSIZE para restringir o comprimento dos dados binários de objetos grandes (BLOB) devolvidos numa instrução SELECT.
SSPROP_NOCOUNT_STATUS Coluna: NoCount

R/W: Só leitura

Tipo: VT_BOOL

Padrão: VARIANT_FALSE

Descrição: Um valor booleano que representa o estado do SET NOCOUNT ON/OFF no SQL Server:

VARIANT_TRUE: quando definir SEM CONTAR ATIVADO

VARIANT_FALSE: quando DESLIGAR O NOCOUNT
SSPROP_QP_NOTIFICATION_MSGTEXT Coluna: Não

R/W: Ler/Escrever

Tipo: VT_BSTR (1-2000 caracteres permitidos)

Padrão: Cadeia vazia

Descrição: O texto da mensagem da notificação da consulta. Isto é definido pelo utilizador e não tem um formato definido.
SSPROP_QP_NOTIFICATION_OPTIONS Coluna: Não

R/W: Ler/Escrever

Tipo: VT_BSTR

Padrão: Cadeia vazia

Descrição: As opções de notificação de consulta. Estas são especificadas numa cadeia com name=value. O utilizador é responsável por criar o serviço e ler as notificações da fila. A sintaxe da cadeia de opções de notificações 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: Ler/Escrever

Tipo: VT_UI4

Padrão: 432000 segundos (5 dias)

Mínimo: 1 segundo

Máximo: 2^31-1 segundo

Descrição: O número de segundos em que a notificação da consulta deve permanecer ativa.

Ver também

Conjuntos de linhas