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>|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. |