Suporte a FILESTREAM (OLE DB)

Aplica-se a: SQL Server

Important

O SQL Server Native Client (geralmente abreviado SNAC) foi removido do SQL Server 2022 (16.x) e do SQL Server Management Studio 19 (SSMS). O provedor OLE DB do SQL Server Native Client (SQLNCLI ou SQLNCLI11) e o provedor Microsoft OLE DB herdado para SQL Server (SQLOLEDB) não são recomendados para novos desenvolvimentos. Mude para o novo Microsoft OLE DB Driver (MSOLEDBSQL) para SQL Server daqui em diante.

A partir do SQL Server 2008 (10.0.x) e do SQL Server Native Client 10.0, o OLE DB suporta a funcionalidade melhorada FILESTREAM. Para mais informações sobre esta funcionalidade, consulte Suporte ao FILESTREAM. Para exemplos, veja Filestream e OLE DB.

Para enviar e receber valores varbinary(max) superiores a 2 GB, uma aplicação utiliza DBTYPE_IUNKNOWN em ligações de parâmetros e resultados. Para os parâmetros, o fornecedor deve chamar IUnknown::QueryInterface para ISequentialStream e para resultados que retornam ISequentialStream.

Para o OLE DB, a verificação relacionada com os valores do ISequentialStream será relaxada. Quando o wType está DBTYPE_IUNKNOWN na estrutura DBBINDING , a verificação de comprimento pode ser desativada omitindo DBPART_LENGTH do dwPart ou definindo o comprimento dos dados (no offset obLength no buffer de dados) para ~0. Neste caso, o fornecedor não verificará o comprimento do valor e solicitará e devolverá todos os dados disponíveis através do fluxo. Esta alteração será aplicada a todos os tipos de objetos grandes (LOB) e XML, mas apenas quando ligados a servidores SQL Server 2005 (9.x) (ou posteriores). Isto proporcionará maior flexibilidade para os programadores, mantendo a consistência e a compatibilidade retroactiva para aplicações existentes e servidores downlevel.

Esta alteração afeta todas as interfaces que transferem dados, principalmente IRowset::GetData, ICommand::Execute e IRowsetFastLoad::InsertRow.

Conteúdo relacionado

  • de programação do SQL Server Native Client
  • Última atualização a