Compartilhar via


SPNs (Nomes da Entidade de Serviço) em conexões de cliente (OLE DB)

Este tópico descreve propriedades de OLE DB e funções de membro que dão suporte a SPNs (nomes da entidade de serviço) nos aplicativos clientes. Para obter mais informações sobre SPNs em aplicativos cliente, consulte Suporte a SPN (Nome da entidade de serviço) em conexões com o cliente.

Palavras-chave de cadeia de inicialização do provedor

As palavras-chave de cadeia de inicialização de provedora seguir dão suporte a SPNs em aplicativos do OLE DB. Na tabela a seguir, os valores na coluna de palavra-chave são usados para a cadeia de caracteres do provedor de IDBInitialize::Initialize. Os valores na coluna de descrição são usados em cadeias de inicialização na conexão usando ADO ou IDataInitialize::GetDataSource.

Palavra-chave

Descrição

Valor

ServerSPN

SPN do servidor

O SPN do servidor. O valor padrão é uma cadeia de caracteres vazia, que faz com que o SQL Server Native Client use o SPN padrão gerado pelo provedor.

FailoverPartnerSPN

SPN do parceiro de failover:

O SPN do parceiro de failover. O valor padrão é uma cadeia de caracteres vazia, que faz com que o SQL Server Native Client use o SPN padrão gerado pelo provedor.

Propriedades de inicialização da fonte de dados

As propriedades a seguir do conjunto de propriedades DBPROPSET_SQLSERVERDBINIT permitem que os aplicativos especifiquem SPNs.

Nome

Tipo

Uso

SSPROP_INIT_SERVERSPN

VT_BSTR, leitura/gravação

Especifica o SPN do servidor. O valor padrão é uma cadeia de caracteres vazia, que faz com que o SQL Server Native Client use o SPN padrão gerado pelo provedor.

SSPROP_INIT_FAILOVERPARTNERSPN

VT_BSTR, leitura/gravação

Especifica o SPN para o parceiro de failover. O valor padrão é uma cadeia de caracteres vazia, que faz com que o SQL Server Native Client use o SPN padrão gerado pelo provedor.

Propriedades da fonte de dados

As propriedades a seguir do conjunto de propriedades DBPROPSET_SQLSERVERDATASOURCEINFO permitem que os aplicativos descubram o método de autenticação.

Nome

Tipo

Uso

SSPROP_INTEGRATEDAUTHENTICATIONMETHOD

VT_BSTR, somente leitura

Retorna o método de autenticação usado para a conexão. O valor retornado ao aplicativo é o valor que o Windows retorna ao SQL Server Native Client. Os seguintes valores são possíveis:

  • "NTLM", que é retornado quando uma conexão é aberta usando a autenticação NTLM.

  • "Kerberos", que é retornado quando uma conexão é aberta usando a autenticação Kerberos.

Se uma conexão foi aberta e não for possível determinar o método de autenticação, VT_EMPTY será retornado.

Essa propriedade só pode ser lida quando uma fonte de dados tiver sido inicializada. Se você tentar ler a propriedade antes da inicialização da fonte de dados, IDBProperties::GetProperies retornará DB_S_ERRORSOCCURRED ou DB_E_ERRORSOCCURRED, conforme apropriado, e DBPROPSTATUS_NOTSUPPORTED será definido em DBPROPSET_PROPERTIESINERROR para essa propriedade. Esse comportamento está de acordo com a especificação principal do OLE DB.

SSPROP_MUTUALLYAUTHENICATED

VT_BOOL, somente leitura

Retorna VARIANT_TRUE se os servidores da conexão forem autenticados mutuamente. Caso contrário, retorna VARIANT_FALSE.

Essa propriedade só pode ser lida quando uma fonte de dados tiver sido inicializada. Se você tentar ler a propriedade antes da inicialização da fonte de dados, IDBProperties::GetProperies retornará DB_S_ERRORSOCCURRED ou DB_E_ERRORSOCCURRED, conforme apropriado, e DBPROPSTATUS_NOTSUPPORTED será definido em DBPROPSET_PROPERTIESINERROR para essa propriedade. Esse comportamento está de acordo com a especificação principal do OLE DB

Se esse atributo for consultado para uma conexão que não usou a Autenticação do Windows, será retornado VARIANT_FALSE.

Suporte de API do OLE DB para SPNs

A tabela a seguir descreve o as funções do membro OLE DB que dá suporte a SPNs em conexões do cliente:

Função de membro

Descrição

IDataInitialize::GetDataSource

As pwszInitializationString podem conter as palavras-chave novas ServerSPN e FailoverPartnerSPN.

IDataInitialize::GetInitializationString

Se SSPROP_INIT_SERVERSPN e SSPROP_INIT_FAILOVERPARTNERSPN tiverem valores fora do padrão, eles serão incluídos na cadeia de inicialização através de ppwszInitString como valores de palavras-chave de ServerSPN e FailoverPartnerSPN. Caso contrário, essas palavras-chave não serão incluídas na cadeia de inicialização.

IDBInitialize::Initialize

Se o aviso for habilitado pela definição de DBPROP_INIT_PROMPT nas propriedades de inicialização da fonte de dados, a caixa de diálogo Logon no OLE DB será exibida. Isto permite que os SPNs sejam digitados para o servidor principal e seu parceiro de failover.

Se a cadeia de caracteres do provedor no DPPROP_INIT_PROVIDERSTRING estiver definida, reconhecerá as novas palavras-chave ServerSPN e FailoverPartnerSPN e usará seus valores, se presentes, para inicializar SSPROP_INIT_SERVER_SPN e SSPROP_INIT_FAILOVER_PARTNER_SPN.

IDBProperties::SetProperties pode ser chamado para definir as propriedades SSPROP_INIT_SERVER_SPN e SSPROP_INIT_FAILOVER_PARTNER_SPN antes de IDBInitialize::Initialize ser chamado. Essa é uma alternativa ao uso de uma cadeia de caracteres de provedor.

Se uma propriedade for definida em mais de um local, um valor definido programaticamente terá precedência sobre de um conjunto de valor na cadeia de caracteres de provedor. Um valor definido na cadeia de inicialização tem precedência sobre um valor definido em uma caixa de diálogo de login.

Se a mesma palavra-chave aparecer mais de uma vez na cadeia de caracteres de provedor, o valor da primeira ocorrência terá precedência.

IDBProperties::GetProperties

IDBProperties::GetProperties pode ser chamado para obter os valores das novas propriedades de inicialização da fonte de dados SSPROP_INIT_SERVERSPN e SSPROP_INIT_FAILOVERPARTNERSPN, e das novas propriedades da fonte de dados SSPROP_AUTHENTICATIONMETHOD e SSPROP_MUTUALLYAUTHENTICATED.

IDBProperties::GetPropertyInfo

IdbProperties::GetPropertyInfo incluirá as novas propriedades de inicialização da fonte de dados SSPROP_INIT_SERVERSPN e SSPROP_INIT_FAILOVERPARTNERSPN, ou as novas propriedades da fonte de dados SSPROP_AUTHENTICATION_METHOD e SSPROP_MUTUALLYAUTHENTICATED.

IDBProperties::SetProperties

IDBProperties::SetProperties pode ser chamado para definir os valores das novas propriedades de inicialização da fonte de dados SSPROP_INITSERVERSPN e SSPROP_INIT_FAILOVERPARTNERSPN.

Essas propriedades podem ser definidas a qualquer momento, mas se a fonte de dados já estiver aberta, o erro a seguir será retornado:DB_E_ERRORSOCCURRED, " Operação de várias etapas do OLE DB gerou erros. Verifique todos os valores de status do OLE DB, se disponíveis. Não foram executados trabalhos."

Consulte também

Conceitos