Propriedades e comportamentos do conjunto de linhas (provedor OLE DB do Native Client)
Aplica-se a:
SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)
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. Observação: 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). 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 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 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 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. 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 as 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 do 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 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 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 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 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. |
Consulte Também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de