Propriedades de inicialização e autorização

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Baixar o driver do OLE DB

O provedor Driver do OLE DB para SQL Server interpreta as propriedades de inicialização e autorização do OLE DB como segue:

ID da propriedade Descrição
DBPROP_AUTH_CACHE_AUTHINFO O provedor do Driver do OLE DB para SQL Server não armazena em cache informações de autenticação.

O Driver do Microsoft OLE DB para SQL Server retorna DB_S_ERRORSOCCURRED em uma tentativa para definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_ENCRYPT_PASSWORD O Driver do OLE DB para SQL Server usa mecanismos padrão de segurança do Microsoft SQL Server para ocultar senhas.

O Driver do Microsoft OLE DB para SQL Server retorna DB_S_ERRORSOCCURRED em uma tentativa para definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_INTEGRATED Se DBPROP_AUTH_INTEGRATED for definido como um ponteiro NULL, uma cadeia de caracteres nula ou um valor 'SSPI' VT_BSTR, o OLE DB Driver for SQL Server usará o Modo de Autenticação do Windows para autorizar o acesso do usuário ao banco de dados do SQL Server especificado pelas propriedades DBPROP_INIT_DATASOURCE e DBPROP_INIT_CATALOG.

Se for definido como VT_EMPTY (o padrão), segurança do SQL Server será usada. O logon e a senha do SQL Server são especificados nas propriedades DBPROP_AUTH_USERID e DBPROP_AUTH_PASSWORD.
DBPROP_AUTH_MASK_PASSWORD O provedor Driver do OLE DB para SQL Server usa mecanismos padrão de segurança do SQL Server para esconder senhas.

O Driver do Microsoft OLE DB para SQL Server retorna DB_S_ERRORSOCCURRED em uma tentativa para definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_PASSWORD Senha atribuída a um logon do SQL Server. Esta propriedade é usada quando Autenticação do SQL Server é selecionada para autorizar acesso a um banco de dados do SQL Server.
DBPROP_AUTH_PERSIST_ENCRYPTED O provedor do Driver do OLE DB para SQL Server não criptografa informações de autenticação quando elas são persistentes.

O Driver do Microsoft OLE DB para SQL Server retorna DB_S_ERRORSOCCURRED em uma tentativa para definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO O OLE DB Driver for SQL Server persiste os valores de autenticação, incluindo uma imagem de uma senha, se assim solicitado. Nenhuma criptografia é fornecida.
DBPROP_AUTH_USERID Logon do SQL Server. Esta propriedade é usada quando Autenticação do SQL Server é selecionada para autorizar acesso a um banco de dados do SQL Server.
DBPROP_INIT_ASYNCH O Driver do OLE DB para SQL Server para SQL Server oferece suporte para inicialização assíncrona.

A definição do bit DBPROPVAL_ASYNCH_INITIALIZE na propriedade DBPROP_INIT_ASYNCH faz com que IDBInitialize::Initialize se torne uma chamada sem bloqueio. Confira mais informações em Realizar Operações Assíncronas.
DBPROP_INIT_CATALOG Nome de um banco de dados existente do SQL Server ao qual se conectar.
DBPROP_INIT_DATASOURCE Nome da rede de um servidor que executa uma instância do Microsoft SQL Server. Se houver várias instâncias do SQL Server em execução no computador, para se conectar a uma instância específica do SQL Server, o valor DBPROP_INIT_DATASOURCE será especificado como \\ServerName\InstanceName. A sequência de escape \\ é usada para a barra invertida.
DBPROP_INIT_GENERALTIMEOUT Indica o número de segundos antes de uma solicitação, que não seja a inicialização da fonte de dados e a execução do comando, expirar. Um valor de 0 indica que nunca expirará. Provedores que trabalham em conexões de rede ou em cenários distribuídos ou transacionados poderão aceitar esta propriedade a fim de orientar um componente inscrito para atingir o tempo limite se houver uma solicitação de longa execução. Os tempos limites para a inicialização da fonte de dados e a execução de comando permanecem controlados por DBPROP_INIT_TIMEOUT e DBPROP_COMMANDTIMEOUT, respectivamente.

DBPROP_INIT_GENERALTIMEOUT é somente leitura e, se uma pessoa tentar defini-lo, o erro dwstatus de DBPROPSTATUS_NOTSETTABLE será retornado.
DBPROP_INIT_HWND O identificador do Windows do aplicativo de chamada. Um identificador de janela válido é necessário para a caixa de diálogo de inicialização exibida quando a solicitação de propriedades de inicialização é permitida.
DBPROP_INIT_IMPERSONATION_LEVEL O Driver do OLE DB para SQL Server não oferece suporte ao ajuste do nível de representação.

O Driver do Microsoft OLE DB para SQL Server retorna DB_S_ERRORSOCCURRED em uma tentativa para definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_LCID O OLE DB Driver for SQL Server valida a identificação de localidade e retorna um erro se ela não é compatível com o cliente ou não está instalada nele.
DBPROP_INIT_LOCATION O Driver do Microsoft OLE DB para SQL Server retorna DB_S_ERRORSOCCURRED em uma tentativa para definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_MODE O Driver do Microsoft OLE DB para SQL Server retorna DB_S_ERRORSOCCURRED em uma tentativa para definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_PROMPT O Driver do OLE DB para SQL Server oferece suporte a todos os modos de solicitação para inicialização da fonte de dados. O Driver do OLE DB para SQL Server usa DBPROMPT_NOPROMPT como sua configuração padrão para a propriedade.
DBPROP_INIT_PROTECTION_LEVEL O Driver do OLE DB para SQL Server não tem suporte de um nível de proteção em conexões com instâncias do SQL Server.

O Driver do Microsoft OLE DB para SQL Server retorna DB_S_ERRORSOCCURRED em uma tentativa para definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_PROVIDERSTRING Veja a cadeia de caracteres do Driver do OLE DB para SQL Server posteriormente neste tópico.
DBPROP_INIT_TIMEOUT O Driver do OLE DB para SQL Server retorna um erro na inicialização caso uma conexão com a instância do SQL Server não possa ser estabelecida dentro do número de segundos especificado.

No conjunto de propriedades específico do provedor DBPROPSET_SQLSERVERDBINIT, o OLE DB Driver for SQL Server define estas propriedades de inicialização adicionais.

ID da propriedade Descrição
SSPROP_AUTH_ACCESS_TOKEN1 Tipo: VT_BSTR

L/G: Leitura/gravação

Padrão: VT_EMPTY

Descrição: o token de acesso usado para autenticar na ID do Microsoft Entra.

OBSERVAÇÃO: É um erro especificar esta propriedade e as palavras-chave de cadeia de conexão UID, PWD, Trusted_Connection ou Authentication, ou as palavras-chave/propriedades correspondentes.
SSPROP_AUTH_MODE1 Tipo: VT_BSTR

L/G: Leitura/gravação

Padrão: VT_EMPTY

Descrição: especifica a autenticação SQL ou Microsoft Entra usada. Os valores válidos são:
  • (not set): Modo de autenticação determinado por outras palavras-chave.
  • (empty string): Remove a definição de um modo de autenticação previamente configurado.
  • ActiveDirectoryPassword:Autenticação de nome de usuário e senha com uma identidade do Microsoft Entra.
  • ActiveDirectoryIntegrated: Autenticação integrada com uma identidade do Microsoft Entra.

  • OBSERVAÇÃO: A palavra-chave ActiveDirectoryIntegrated também pode ser usada para a autenticação do Windows para SQL Server. Ela substitui as palavras-chave de autenticação do Integrated Security (ou Trusted_Connection). É recomendável que os aplicativos que usam palavras-chave de Integrated Security (ou Trusted_Connection) ou as propriedades correspondentes delas definam a palavra-chave de Authentication (ou a propriedade correspondente dela) como ActiveDirectoryIntegrated a fim de habilitar um novo comportamento de validação de certificado e criptografia.

  • ActiveDirectoryInteractive: Autenticação interativa com uma identidade do Microsoft Entra. Esse método é compatível com a autenticação multifator do Microsoft Entra.
  • Autenticação de identidade gerenciada do ActiveDirectoryMSI:. Para uma identidade atribuída ao usuário, a ID de usuário deve ser definida como a ID de objeto da identidade do usuário.
  • ActiveDirectoryServicePrincipal: Autenticação da entidade de serviço com um aplicativo do Microsoft Entra. A ID de usuário deve ser definida como a ID do aplicativo (cliente). A senha deve ser definida como o segredo do aplicativo (cliente).
  • SqlPassword: Autenticação usando a ID de usuário e a senha.

  • OBSERVAÇÃO: É recomendável que os aplicativos que usam a autenticação SQL Server definam a palavra-chave de Authentication (ou a propriedade correspondente dela) como SqlPassword a fim de habilitar um novo comportamento de validação de certificado e criptografia.
SSPROP_AUTH_OLD_PASSWORD Tipo: VT_BSTR

L/G: Gravar

Padrão: VT_EMPTY

Descrição: A senha atual ou expirada. Confira mais informações em Alterar senhas programaticamente.
SSPROP_INIT_APPNAME Tipo: VT_BSTR

L/G: Leitura/gravação

Descrição: O nome do aplicativo cliente.
SSPROP_INIT_AUTOTRANSLATE Tipo: VT_BOOL

L/G: Leitura/gravação

Padrão: VARIANT_TRUE

Descrição: Conversão de caractere OEM/ANSI.

VARIANT_TRUE: o Driver do OLE DB para SQL Server converte as cadeias de caracteres ANSI enviadas entre o cliente e o servidor por Unicode para minimizar problemas na correspondência de caracteres estendidos entre as páginas de códigos no cliente e no servidor:

Os dados de DBTYPE_STR do cliente enviados a uma instância de variável, parâmetro ou coluna char, varchar ou text do SQL Server são convertidos de caractere em Unicode usando a ACP (página de código ANSI) do cliente e, em seguida, convertidos de Unicode em caractere usando a ACP do servidor.

Os dados char, varchar ou text do SQL Server enviados a uma variável DBTYPE_STR do cliente são convertidos de caractere em Unicode usando a ACP do servidor e, em seguida, convertidos de Unicode em caractere usando a ACP do cliente.

Para as versões 18.6.4 e 19.1 e posteriores do driver do OLE DB, as conversões acima também se aplicam a dados transferidos entre um membro CharVal da estrutura SSVARIANT e uma instância de variável, parâmetro ou coluna sql_variant do SQL Server.

Essas conversões são executadas no cliente pelo Driver do OLE DB para SQL Server. Isto requer que a mesma ACP usada no servidor esteja disponível no cliente.

Estas configurações não têm nenhum efeito nas conversões que ocorrem para estas transferências:

Dados de cliente de DBTYPE_WSTR Unicode enviados para char, varchar ou text no servidor.

Dados de servidor char, varchar ou text enviados para uma variável DBTYPE_WSTR Unicode no cliente.

Dados de cliente DBTYPE_STR ANSI enviados a nchar, nvarchar ou ntext Unicode no servidor.

Dados de servidor char, varchar ou text Unicode enviados para uma variável DBTYPE_STR de ANSI no cliente.

VARIANT_FALSE: o driver do OLE DB para SQL Server não realiza a tradução de caracteres.

O OLE DB Driver for SQL Server não converte os dados DBTYPE_STR de caractere ANSI do cliente enviados às variáveis char, varchar ou text, aos parâmetros ou às colunas no servidor. Nenhuma conversão é executada nos dados char, varchar ou text enviados do servidor a variáveis DBTYPE_STR no cliente. De modo semelhante, para as versões 18.6.4 e 19.1 e posteriores do driver do OLE DB, o driver não converte os dados transferidos entre um membro CharVal da estrutura SSVARIANT e uma instância de variável, parâmetro ou coluna sql_variant do SQL Server.

Se o cliente e a instância do SQL Server estiverem usando ACPs diferente, os caracteres estendidos poderão ser interpretados incorretamente.
SSPROP_INIT_CONNECT_RETRY_COUNT Tipo: VT_I4

L/G: Leitura/gravação

Padrão: 1

Descrição: controla o número de tentativas de reconexão em caso de perda de conexão. Para obter mais informações, confira Resiliência de conexão ociosa.
SSPROP_INIT_CONNECT_RETRY_INTERVAL Tipo: VT_I4

L/G: Leitura/gravação

Padrão: 10

Descrição: especifica o número de segundos entre cada tentativa de conexão em caso de perda de conexão. Para obter mais informações, confira Resiliência de conexão ociosa.
SSPROP_INIT_CURRENTLANGUAGE Tipo: VT_BSTR

L/G: Leitura/gravação

Descrição: Um nome de idioma SQL Server. Identifica o idioma usado para seleção de mensagem de sistema e formatação. O idioma deve estar instalado no computador que executa uma instância do SQL Server ou a inicialização da fonte de dados falhará.
SSPROP_INIT_DATATYPECOMPATIBILITY Tipo: VT_UI2

L/G: Leitura/gravação

Padrão: 0

Descrição: Habilita a compatibilidade de tipo de dados entre os aplicativos SQL Server e ActiveX Data Object (ADO). Se o valor padrão 0 for usado, a manipulação do tipo de dados assumirá como padrão aquele usado pelo provedor. Se o valor 80 for usado, a manipulação do tipo de dados usará apenas os tipos de dados do SQL Server 2000 (8.x). Confira mais informações em Usar o ADO com o Driver do OLE DB para SQL Server.
SSPROP_INIT_DISCOVEREDSERVERSPN Tipo: VT_BSTR

Leitura/gravação: leitura

Descrição: usado para consultar o SPN do servidor de uma conexão. (Versão 18.6.3 ou posterior)
SSPROP_INIT_ENCRYPT1 Tipo: VT_BSTR

Leitura/gravação: leitura/gravação

Padrão: Mandatory

Descrição: especifica se os dados serão criptografados pela rede.

Se a opção Forçar Criptografia de Protocolo estiver ativada, a criptografia sempre ocorrerá, independentemente da configuração de SSPROP_INIT_ENCRYPT. Se estiver desativada e a propriedade SSPROP_INIT_ENCRYPT estiver definida para Mandatory ou Strict, a criptografia ocorrerá

Se Forçar Criptografia de Protocolo estiver desativada e SSPROP_INIT_ENCRYPT for definida como Optional, nenhuma criptografia ocorrerá. Os valores válidos são: Optional, Mandatory e Strict. Para as versões 18.x.x, confira Diferenças de versões principais do MSOLEDBSQL.
SSPROP_INIT_FAILOVERPARTNER Tipo: VT_BSTR

L/G: Leitura/gravação

Descrição: Especifica o nome do parceiro de failover para espelhamento de banco de dados. Ela é uma propriedade de inicialização e pode ser definida somente antes da inicialização. Depois da inicialização, ela retornará o parceiro de failover, se houver, retornado pelo servidor primário.

Isso permite que um aplicativo inteligente armazene em cache o servidor de backup determinado mais recentemente, mas esses aplicativos devem saber que as informações são atualizadas somente depois que a conexão é estabelecida pela primeira vez (ou redefinida, se estiver inserida em pool) e podem ficar desatualizadas em conexões de longo prazo.

Depois de estabelecer a conexão, o aplicativo pode consultar este atributo para determinar a identidade do parceiro de failover. Se o servidor primário não tiver nenhum parceiro de failover, esta propriedade retornará uma cadeia de caracteres vazia. Para obter mais informações, confira Usando o espelhamento de banco de dados.
SSPROP_INIT_FAILOVERPARTNERSPN Tipo: VT_BSTR

L/G: Leitura/gravação

Padrão: VT_EMPTY

Descrição: especifica o SPN do parceiro de failover. Uma cadeia de caracteres vazia faz com que o Driver do OLE DB para SQL Server use o SPN padrão gerado pelo provedor.
SSPROP_INIT_FILENAME Tipo: VT_BSTR

L/G: Leitura/gravação

Descrição: Especifica o nome do arquivo primário de um banco de dados anexável. Esse banco de dados é anexado e torna-se o banco de dados padrão da conexão. Para usar SSPROP_INIT_FILENAME, você deve especificar o nome do banco de dados como o valor da propriedade de inicialização DBPROP_INIT_CATALOG. Se o nome do banco de dados não existir, este procedimento procurará o nome do arquivo primário especificado em SSPROP_INIT_FILENAME e anexará esse banco de dados ao nome especificado em DBPROP_INIT_CATALOG. Se o banco de dados tiver sido anexado previamente, o SQL Server não o anexará novamente.
SSPROP_INIT_HOST_NAME_CERTIFICATE Tipo: VT_BSTR

L/G: Leitura/gravação

Padrão: VT_EMPTY

Descrição: o nome do host a ser usado na validação do certificado TLS/SSL do SQL Server. Se a propriedade SSPROP_INIT_HOST_NAME_CERTIFICATE não estiver definida, o driver usará o valor da propriedade DBPROP_INIT_DATASOURCE como o nome do host para validar o certificado TLS/SSL do SQL Server.
SSPROP_INIT_MARSCONNECTION Tipo: VT_BOOL

L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: Especifica se os MARS (Vários Conjuntos de Resultados Ativos) estão habilitados para a conexão. Esta opção deve ser definida como verdadeira antes de uma conexão com o banco de dados ser estabelecida. Para obter mais informações, consulte Usando MARS (vários conjuntos de resultados ativos).
SSPROP_INIT_MULTISUBNETFAILOVER Tipo: VT_BOOL

L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: O MultiSubnetFailover permite o failover mais rápido para todos os Grupos de Disponibilidade Always On e as Instâncias de Cluster de Failover no SQL Server e reduz significativamente o tempo de failover para topologias sempre ativadas de uma ou várias sub-redes. Durante um failover de várias sub-redes, o cliente tentará conexões em paralelo. Para obter mais informações, confira Compatibilidade do Driver do OLE DB para SQL Server com Alta Disponibilidade e Recuperação de Desastre.
SSPROP_INIT_NETWORKADDRESS Tipo: VT_BSTR

L/G: Leitura/gravação

Descrição: O endereço de rede do servidor que executa uma instância do SQL Server especificada pela propriedade DBPROP_INIT_DATASOURCE.
SSPROP_INIT_NETWORKLIBRARY Tipo: VT_BSTR

L/G: Leitura/gravação

Descrição: O nome do networklibrary (DLL) usado para comunicação com uma instância do SQL Server. O nome não deve incluir o caminho ou a extensão de nome de arquivo .dll.

O padrão pode ser personalizado usando o Utilitário de Configuração do Cliente SQL Server.

Observação: Somente os protocolos TCP e Pipes Nomeados são aceitos por esta propriedade. Se você usar esta propriedade com um prefixo, acabará com um prefixo duplo que resultará em erro, pois a propriedade é usada para gerar um prefixo internamente.
SSPROP_INIT_PACKETSIZE Tipo: VT_I4

L/G: Leitura/gravação

Descrição: Tamanho de um pacote TDS (protocolo TDS) em bytes. O valor da propriedade tamanho do pacote deve ser 0 ou estar entre 512 e 32.767. O valor padrão é 0, o que significa que o tamanho real do pacote será determinado pelo servidor.
SSPROP_INIT_SERVER_CERTIFICATE Tipo: VT_BSTR

L/G: Leitura/gravação

Padrão: VT_EMPTY

Descrição: especifica o caminho para um arquivo de certificado a ser correspondido com o certificado TLS/SSL do SQL Server. Essa opção só pode ser usada quando a criptografia Strict está habilitada. Os formatos de certificado aceitos são PEM, DER e CER. Se especificado, o certificado SQL Server será verificado analisando se o certificado fornecido é uma correspondência exata.
SSPROP_INIT_SERVERSPN Tipo: VT_BSTR

L/G: Leitura/gravação

Padrão: VT_EMPTY

Descrição: especifica o SPN do servidor. Uma cadeia de caracteres vazia faz com que o Driver do OLE DB para SQL Server use o SPN padrão gerado pelo provedor.
SSPROP_INIT_TAGCOLUMNCOLLATION Tipo: VT_BOOL

L/G: Gravar

Padrão: VARIANT_FALSE

Descrição: É usado durante uma atualização de banco de dados quando são usados cursores do lado de servidor. Esta propriedade marca os dados com informações de ordenação obtidas do servidor, em vez da página de códigos no cliente. Atualmente, esta propriedade só é usada pelo processo de consulta distribuída porque ele sabe a ordenação de dados de destino e converte-os corretamente.
SSPROP_INIT_TNIR Tipo: VT_BOOL

L/G: Leitura/gravação

Padrão: VARIANT_TRUE

Descrição: Quando há vários IPs associados ao nome do host, a TNIR afeta a sequência de conexão quando o primeiro IP resolvido do nome do host não responde. A TNIR interage com MultiSubnetFailover para fornecer diferentes sequências de conexão. Para saber mais, confira Usar resolução de IP de rede transparente.
SSPROP_INIT_TRUST_SERVER_CERTIFICATE1 Tipo: VT_BOOL

L/G: Leitura/gravação

Padrão: VARIANT_FALSE

Descrição: Usada para habilitar ou desabilitar a validação de certificado do servidor. Esta propriedade é de leitura/gravação, mas uma tentativa de defini-la depois que uma conexão foi estabelecida resultará em um erro.

Essa propriedade será ignorada se o cliente for configurado para exigir validação de certificado. Entretanto, um aplicativo poderá usá-la juntamente com SSPROP_INIT_ENCRYPT para garantir que sua conexão com o servidor seja criptografada, mesmo se o cliente estiver configurado para não solicitar criptografia e nenhum certificado for provisionado no cliente.

Aplicativos cliente podem consultar esta propriedade depois que uma conexão foi aberta para determinar as configurações efetivas de criptografia e validação em uso.

Observação: O uso da criptografia sem validação de certificado fornece proteção parcial contra a detecção de pacote, mas não protege contra ataques a intermediários. Ela simplesmente permite criptografar o logon e os dados enviados ao servidor sem validar o certificado do servidor.

Para obter mais informações, veja Criptografia e validação de certificado.
SSPROP_INIT_USEPROCFORPREP Tipo: VT_I4

L/G: Leitura/gravação

Padrão: SSPROPVAL_USEPROCFORPREP_ON

Descrição: o uso do procedimento armazenado SQL Server. Define o uso de procedimentos armazenados temporários do SQL Server para dar suporte à interface ICommandPrepare. Esta propriedade era significativa apenas na conexão ao SQL Server 6.5. A propriedade é ignorada para versões posteriores.

SSPROPVAL_USEPROCFORPREP_OFF: um procedimento armazenado temporário não é criado quando um comando está preparado.

SSPROPVAL_USEPROCFORPREP_ON: um procedimento armazenado temporário é criado quando um comando está preparado. Os procedimentos armazenados temporários são descartados quando a sessão é liberada.

SSPROPVAL_USEPROCFORPREP_ON_DROP: um procedimento armazenado temporário é criado quando um comando está preparado. O procedimento é removido quando o comando não está preparado com ICommandPrepare::Unprepare, quando um novo comando é especificado para o objeto do comando com ICommandText::SetCommandText ou quando todas as referências do aplicativo ao comando são liberadas.
SSPROP_INIT_WSID Tipo: VT_BSTR

L/G: Leitura/gravação

Descrição: uma cadeia de caracteres que identifica a estação de trabalho.

[1]: Para aprimorar a segurança, a criptografia e o comportamento de validação de certificado são modificados ao usar as propriedades de inicialização do token de acesso ou da autenticação ou as palavras-chave de cadeia de conexão correspondentes. Para obter detalhes, confira Criptografia e validação de certificado.

No conjunto de propriedades específico do provedor DBPROPSET_SQLSERVERDATASOURCEINFO, o Driver do OLE DB para SQL Server define as propriedades adicionais, confira mais informações em Propriedades de Informações de Fontes de Dados.

A cadeia de caracteres do OLE DB Driver for SQL Server

O Driver do OLE DB para SQL Server reconhece uma sintaxe como ODBC em valores de propriedade da cadeia de caracteres do provedor. A propriedade da cadeia de caracteres do provedor é fornecida como o valor da propriedade de inicialização do OLE DB DBPROP_INIT_PROVIDERSTRING quando uma conexão é estabelecida com a fonte de dados do OLE DB. Essa propriedade especifica os dados de conexão específicos do provedor OLE DB necessários para implementar uma conexão com a fonte de dados do OLE DB. Dentro da cadeia de caracteres, os elementos são delimitados usando um ponto-e-vírgula. O elemento final na cadeia de caracteres deve terminar com um ponto-e-vírgula. Cada elemento consiste em uma palavra-chave, em um caractere de sinal de igual e no valor transmitido na inicialização. Por exemplo:

Server=MyServer;UID=MyUserName;  

Com o Driver do OLE DB para SQL Server, o consumidor nunca precisa usar a propriedade de cadeia de caracteres de provedor. O consumidor pode definir qualquer propriedade de inicialização refletida na cadeia de caracteres do provedor usando o OLE DB ou as propriedades de inicialização específicas do OLE DB Driver for SQL Server.

Para obter uma lista de palavras-chave disponíveis no Driver do OLE DB para SQL Server, confira Como usar palavras-chave de cadeia de conexão com o Driver do OLE DB para SQL Server.

Consulte Também

Objetos de fonte de dados (OLE DB)