Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O provedor OLE DB do SQL Server Native Client interpreta as propriedades de inicialização e autorização do OLE DB da seguinte maneira:
| ID da Propriedade | Descrição |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | O provedor OLE DB do SQL Server Native Client não armazena em cache as informações de autenticação. O provedor OLE DB do SQL Server Native Client retorna DB_S_ERRORSOCCURRED em uma tentativa de definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_ENCRYPT_PASSWORD | O provedor OLE DB do SQL Server Native Client usa mecanismos de segurança padrão do MicrosoftSQL Server para ocultar senhas. O provedor OLE DB do SQL Server Native Client retorna DB_S_ERRORSOCCURRED em uma tentativa de 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 VT_BSTR 'SSPI', o provedor OLE DB do SQL Server Native Client 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 estiver definido como VT_EMPTY (o padrão), a 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 OLE DB do SQL Server Native Client usa mecanismos de segurança padrão do SQL Server para ocultar senhas. O provedor OLE DB do SQL Server Native Client retorna DB_S_ERRORSOCCURRED em uma tentativa de 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. Essa propriedade é usada quando a Autenticação do SQL Server é selecionada para autorizar o acesso a um banco de dados do SQL Server. |
| DBPROP_AUTH_PERSIST_ENCRYPTED | O provedor OLE DB do SQL Server Native Client não criptografa as informações de autenticação quando persistidas. O provedor OLE DB do SQL Server Native Client retorna DB_S_ERRORSOCCURRED em uma tentativa de definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | O provedor OLE DB do SQL Server Native Client persiste os valores de autenticação, incluindo uma imagem de uma senha, se solicitado. Nenhuma criptografia é fornecida. |
| Identificador de Usuário do DBPROP_AUTH_USERID | Logon do SQL Server. Essa propriedade é usada quando a Autenticação do SQL Server é selecionada para autorizar o acesso a um banco de dados do SQL Server. |
| DBPROP_INIT_ASYNCH | O provedor OLE DB do SQL Server Native Client dá suporte à iniciação assíncrona. Definir o bit DBPROPVAL_ASYNCH_INITIALIZE na propriedade DBPROP_INIT_ASYNCH faz com que IDBInitialize::Initialize se torne uma chamada sem bloqueio. Para obter mais informações, consulte Como executar 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 de rede de um servidor executando uma instância do MicrosoftSQL 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 barra invertida em si. |
| DBPROP_INIT_GENERALTIMEOUT | Indica o número de segundos antes de uma solicitação, além da inicialização da fonte de dados e da execução de comando, atingir o tempo limite. Um valor de 0 indica um tempo limite infinito. Provedores que trabalham em conexões de rede ou em cenários distribuídos ou transacionados podem dar suporte a essa propriedade para aconselhar um componente inscrito a perder tempo no caso de uma solicitação de longa execução. Os tempos limite para inicialização da fonte de dados e execução de comando permanecem regidos por DBPROP_INIT_TIMEOUT e DBPROP_COMMANDTIMEOUT, respectivamente. DBPROP_INIT_GENERALTIMEOUT é somente leitura e, se 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 provedor OLE DB do SQL Server Native Client não dá suporte ao ajuste de nível de representação. O provedor OLE DB do SQL Server Native Client retorna DB_S_ERRORSOCCURRED em uma tentativa de definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_LCID | O provedor OLE DB do SQL Server Native Client valida a ID da localidade e retorna um erro se a ID da localidade não tem suporte ou não está instalada no cliente. |
| Local de Inicialização do DBPROP | O provedor OLE DB do SQL Server Native Client retorna DB_S_ERRORSOCCURRED em uma tentativa de definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_MODE | O provedor OLE DB do SQL Server Native Client retorna DB_S_ERRORSOCCURRED em uma tentativa de definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROMPT (Prompt de Inicialização do Banco de Dados) | O provedor OLE DB do SQL Server Native Client dá suporte a todos os modos de solicitação para inicialização da fonte de dados. O provedor OLE DB do SQL Server Native Client usa DBPROMPT_NOPROMPT como sua configuração padrão para a propriedade. |
| DBPROP_INIT_PROTECTION_LEVEL | O provedor OLE DB do SQL Server Native Client não dá suporte a um nível de proteção em conexões com instâncias do SQL Server. O provedor OLE DB do SQL Server Native Client retorna DB_S_ERRORSOCCURRED em uma tentativa de definir o valor da propriedade. O membro dwStatus da Estrutura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
| DBPROP_INIT_PROVIDERSTRING | Consulte a cadeia de caracteres do provedor OLE DB do SQL Server Native Client mais adiante neste tópico. |
| DBPROP_INIT_TIMEOUT | O provedor OLE DB do SQL Server Native Client retorna um erro na inicialização se uma conexão com a instância do SQL Server não puder ser estabelecida dentro do número de segundos especificado. |
No conjunto de propriedades específico do provedor DBPROPSET_SQLSERVERDBINIT, o provedor OLE DB do SQL Server Native Client define essas propriedades de inicialização adicionais.
| ID da Propriedade | Descrição |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | Tipo: VT_BSTR R/W: Gravação Padrão: VT_EMPTY Descrição: a senha atual ou expirada. Para obter mais informações, consulte Alterando senhas programaticamente. |
| SSPROP_INIT_APPNAME | Tipo: VT_BSTR R/W: leitura/gravação Descrição: o nome do aplicativo cliente. |
| SSPROP_INIT_AUTOTRANSLATE | Tipo: VT_BOOL R/W: leitura/gravação Padrão: VARIANT_TRUE Descrição: conversão de caracteres OEM/ANSI. VARIANT_TRUE: o provedor OLE DB do SQL Server Native Client converte cadeias de caracteres ANSI enviadas entre o cliente e o servidor convertendo por meio do Unicode para minimizar problemas na correspondência de caracteres estendidos entre as páginas de código no cliente e no servidor: O cliente DBTYPE_STR dados enviados para uma instância do SQL Serverchar, varchar ou variável de texto , parâmetro ou coluna é convertido de caractere em Unicode usando a ACP (página de código ANSI) do cliente e convertido de Unicode em caractere usando a ACP do servidor. Os dados de caractere, varchar ou texto do SQL Server enviados a um cliente DBTYPE_STR variável são convertidos de caractere em Unicode usando o ACP do servidor e convertidos de Unicode em caractere usando a ACP do cliente. Essas conversões são executadas no cliente pelo provedor OLE DB do SQL Server Native Client. Isso requer que o mesmo ACP usado no servidor esteja disponível no cliente. Essas configurações não têm efeito sobre as conversões que ocorrem para essas transferências: Unicode DBTYPE_WSTR dados do cliente enviados para char, varchar ou texto no servidor. char, varchar ou dados de servidor de texto enviados para uma variável de DBTYPE_WSTR Unicode no cliente. ANSI DBTYPE_STR dados do cliente enviados para Unicode nchar, nvarchar ou ntext no servidor. Dados de servidor de texto, varchar ou caractere Unicode enviados para uma variável de DBTYPE_STR ANSI no cliente. VARIANT_FALSE: o provedor OLE DB do SQL Server Native Client não executa traduções de caracteres. O provedor OLE DB do SQL Server Native Client não converte o caractere ANSI do cliente DBTYPE_STR dados enviados para variáveis de caractere, varchar ou texto , parâmetros ou colunas no servidor. Nenhuma tradução é executada em dados de caractere, varchar ou texto enviados do servidor para DBTYPE_STR variáveis no cliente. Se o cliente e a instância do SQL Server estiverem usando ACPs diferentes, caracteres estendidos poderão ser interpretados incorretamente. |
| SSPROP_INIT_CURRENTLANGUAGE | Tipo: VT_BSTR R/W: leitura/gravação Descrição: um nome de linguagem do SQL Server. Identifica o idioma usado para seleção e formatação de mensagens do sistema. O idioma deve ser instalado no computador que executa uma instância do SQL Server ou falha na inicialização da fonte de dados. |
| SSPROP_INIT_DATATYPECOMPATIBILITY | Tipo: VT_UI2 R/W: leitura/gravação Padrão: 0 Descrição: habilita a compatibilidade de tipo de dados entre aplicativos do SQL Server e do ADO (ActiveX Data Object). Se o valor padrão de 0 for usado, o tratamento de tipo de dados será padrão para o usado pelo provedor. Se o valor de 80 for usado, o tratamento de tipo de dados usará apenas os tipos de dados do SQL Server 2000. Para obter mais informações, consulte Como usar o ADO com o SQL Server Native Client. |
| SSPROP_INIT_ENCRYPT | Tipo: VT_BOOL R/W: leitura/gravação Padrão: VARIANT_FALSE Descrição: para criptografar os dados que passam pela rede, SSPROP_INIT_ENCRYPT propriedade é definida como VARIANT_TRUE. Se Habilitar Criptografia de Protocolo estiver ativada, a criptografia sempre ocorrerá, independentemente da configuração de SSPROP_INIT_ENCRYPT. Se estiver desativado e SSPROP_INIT_ENCRYPT estiver definido como VARIANT_TRUE, a criptografia ocorrerá. Se Habilitar Criptografia de Protocolo estiver desativado e SSPROP_INIT_ENCRYPT estiver definido como VARIANT_FALSE, nenhuma criptografia ocorrerá. |
| SSPROP_INIT_FAILOVERPARTNER | Tipo: VT_BSTR R/W: leitura/gravação Descrição: especifica o nome do parceiro de failover para espelhamento de banco de dados. É uma propriedade de inicialização e só pode ser definida antes da inicialização. Após a inicialização, ele 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 estar cientes de que as informações só são atualizadas quando a conexão é estabelecida pela primeira vez (ou redefinida, se em pool) e podem ficar desatualizadas para conexões de longo prazo. Depois de fazer a conexão, o aplicativo pode consultar esse atributo para determinar a identidade do parceiro de failover. Se o servidor primário não tiver nenhum parceiro de failover, essa propriedade retornará uma cadeia de caracteres vazia. Para obter mais informações, consulte Como usar o espelhamento de banco de dados. |
| SSPROP_INIT_FILENAME | Tipo: VT_BSTR R/W: 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 se torna o banco de dados padrão para a 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, ele procurará o nome do arquivo primário especificado em SSPROP_INIT_FILENAME e anexa esse banco de dados com o nome especificado em DBPROP_INIT_CATALOG. Se o banco de dados foi anexado anteriormente, o SQL Server não o reanexa. |
| SSPROP_INIT_MARSCONNECTION | Tipo: VT_BOOL R/W: leitura/gravação Padrão: VARIANT_FALSE Descrição: especifica se vários MARS (Conjuntos de Resultados Ativos) estão habilitados para a conexão. Essa opção deve ser definida como true antes que uma conexão seja feita com o banco de dados. Para obter mais informações, consulte Usando MARS (vários conjuntos de resultados ativos). |
| SSPROP_INIT_NETWORKADDRESS | Tipo: VT_BSTR R/W: 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 R/W: leitura/gravação Descrição: o nome da DLL (networklibrary) usada para se comunicar 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 de Cliente do SQL Server. Nota: Somente TCP e Pipes Nomeados são compatíveis com essa propriedade. Se você usar essa propriedade com um prefixo, você acabará com um prefixo duplo que resulta em um erro, pois a propriedade é usada para gerar um prefixo internamente. |
| SSPROP_INIT_PACKETSIZE | Tipo: VT_I4 R/W: leitura/gravação Descrição: um tamanho de pacote de rede em bytes. O valor da propriedade de tamanho do pacote deve estar entre 512 e 32.767. O tamanho padrão do pacote de rede do provedor OLE DB do SQL Server Native Client é 4.096. |
| SSPROP_INIT_TAGCOLUMNCOLLATION | Tipo: BOOL R/W: Gravação Padrão: FALSE Descrição: é usado durante uma atualização de banco de dados quando cursores do lado do servidor são usados. Essa propriedade marca os dados com informações de ordenação obtidas do servidor em vez da página de código no cliente. Atualmente, essa propriedade é usada apenas pelo processo de consulta distribuída porque conhece a ordenação de dados de destino e a converte corretamente. |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | Tipo: VT_BOOL R/W: leitura/gravação Padrão: VARIANT_FALSE Descrição: usado para habilitar ou desabilitar a validação do certificado do servidor. Essa propriedade é de leitura/gravação, mas tentar defini-la depois que uma conexão for estabelecida resultará em um erro. Essa propriedade será ignorada se o cliente estiver configurado para exigir a validação do certificado. No entanto, um aplicativo pode usá-lo junto com SSPROP_INIT_ENCRYPT para garantir que sua conexão com o servidor seja criptografada, mesmo que o cliente esteja configurado para não exigir criptografia e nenhum certificado seja provisionado no cliente. Os aplicativos cliente podem consultar essa propriedade depois que uma conexão for aberta para determinar as configurações reais de criptografia e validação em uso. Nota: O uso de criptografia sem validação de certificado fornece proteção parcial contra detecção de pacotes, mas não protege contra ataques man-in-the-middle. Ele simplesmente permite criptografar o logon e os dados enviados ao servidor sem validar o certificado do servidor. Para obter mais informações, consulte Como usar criptografia sem validação. |
| SSPROP_INIT_USEPROCFORPREP | Tipo: VT_I4 R/W: leitura/gravação Padrão: SSPROPVAL_USEPROCFORPREP_ON Descrição: o uso do procedimento armazenado do SQL Server. Define o uso de procedimentos armazenados temporários do SQL Server para dar suporte à interface ICommandPrepare . Essa propriedade só foi significativa ao se conectar 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 é preparado. SSPROPVAL_USEPROCFORPREP_ON: um procedimento armazenado temporário é criado quando um comando é 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 é preparado. O procedimento é descartado quando o comando é despreparado com ICommandPrepare::Unprepare, quando um novo comando é especificado para o objeto de comando com ICommandText::SetCommandText ou quando todas as referências de aplicativo ao comando são liberadas. |
| SSPROP_INIT_WSID | Tipo: VT_BSTR R/W: leitura/gravação Descrição: uma cadeia de caracteres que identifica a estação de trabalho. |
No conjunto de propriedades específico do provedor DBPROPSET_SQLSERVERDATASOURCEINFO, o provedor OLE DB do SQL Server Native Client define as propriedades adicionais; consulte Propriedades de informações da fonte de dados para obter mais informações.
A cadeia de caracteres do provedor OLE DB de cliente nativo do SQL Server
O provedor OLE DB do SQL Server Native Client reconhece uma sintaxe semelhante a ODBC em valores de propriedade de cadeia de caracteres do provedor. A propriedade de cadeia de caracteres do provedor é fornecida como o valor da propriedade de inicialização OLE DB DBPROP_INIT_PROVIDERSTRING quando uma conexão é estabelecida com a fonte de dados 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 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 ser encerrado com um ponto e vírgula. Cada elemento consiste em uma palavra-chave, um caractere de sinal igual e o valor passado na inicialização. Por exemplo:
Server=MyServer;UID=MyUserName;
Com o provedor OLE DB do SQL Server Native Client, o consumidor nunca precisa usar a propriedade de cadeia de caracteres do provedor. O consumidor pode definir qualquer propriedade de inicialização refletida na cadeia de caracteres do provedor usando as propriedades de inicialização específicas do provedor OLE DB ou do SQL Server Native Client.
Para obter uma lista das palavras-chave disponíveis no provedor OLE DB do SQL Server Native Client, consulte Usando palavras-chave de cadeia de conexão com o SQL Server Native Client.