以编程方式更改密码

在 SQL Server 2005 之前,如果用户的密码过期,则只有管理员能对其进行重置。从 SQL Server 2005 开始,SQL Server Native Client 支持通过 SQL Server Native Client OLE DB 访问接口和 SQL Server Native Client ODBC 驱动程序以编程方式处理密码过期,以及通过对**“SQL Server 登录名”**对话框进行更改来进行处理。

注意注意

如果可能,请在运行时提示用户输入他们的凭据,并避免用持久化格式存储他们的凭据。如果必须保留他们的凭据,则应使用 Win32 crypto API(Win32 加密 API)对这些凭据进行加密。有关密码的使用的详细信息,请参阅强密码

SQL Server 登录错误代码

当由于身份验证问题而导致无法连接时,以下 SQL Server 错误代码之一可供应用程序使用,以帮助诊断和恢复。

SQL Server 错误代码

错误消息

15113

用户 '%.*ls' 登录失败。原因: 密码验证失败。帐户已锁定。

18463

用户 '%.*ls' 登录失败。原因: 密码更改失败。此时无法使用密码。

18464

用户 '%.*ls' 登录失败。原因: 密码更改失败。该密码太短,不符合策略要求。

18465

用户 '%.*ls' 登录失败。原因: 密码更改失败。密码太长,不符合策略要求。

18466

用户 '%.*ls' 登录失败。原因: 密码更改失败。该密码不够复杂,不符合策略要求。

18467

用户 '%.*ls' 登录失败。原因: 密码更改失败。该密码不符合密码筛选器 DLL 的要求。

18468

用户 '%.*ls' 登录失败。原因: 密码更改失败。在密码验证过程中出错。

18487

用户 '%.*ls' 登录失败。原因: 该帐户的密码已过期。

18488

用户 '%.*ls' 登录失败。原因: 该帐户的密码必须更改。

有关处理 SQL Server 错误的详细信息,请参阅处理应用程序中的错误和消息

SQL Server Native Client OLE DB 访问接口

SQL Server Native Client OLE DB 访问接口支持通过用户界面以及以编程方式处理密码过期。

OLE DB 用户界面密码过期

SQL Server Native Client OLE DB 访问接口支持通过对**“SQL Server 登录名”**对话框进行更改来处理密码过期。如果将 DBPROP_INIT_PROMPT 的值设置为 DBPROMPT_NOPROMPT,则在密码已过期的情况下初始连接尝试将失败。

如果 DBPROP_INIT_PROMPT 已设置为任何其他值,则无论密码是否已过期,用户都会看到**“SQL Server 登录名”对话框。用户可单击“选项”按钮并选中“更改密码”**来更改密码。

如果用户单击“确定”且密码已过期,则 SQL Server 会提示用户使用**“更改 SQL Server 密码”**对话框输入并确认新密码。

OLE DB 提示行为和锁定的帐户

连接尝试可能会由于帐户被锁定而失败。如果在显示**“SQL Server 登录名”对话框之后发生这种情况,则将向用户显示服务器错误消息,并且连接尝试将中止。如果在显示“更改 SQL Server 密码”**对话框后用户输入错误的旧密码值,则也会出现这种情况。在这种情况下,将显示相同的错误消息,并且连接尝试将中止。

OLE DB 连接池、密码过期和锁定的帐户

当连接在连接池中仍处于活动状态时,帐户可能被锁定或其密码可能已过期。服务器会在以下两种情况下检查密码是否已过期以及帐户是否已锁定。第一种情况是首次创建连接时。第二种情况是从相应池中获取相应连接以重置连接时。

如果重置尝试失败,则将从相应池中删除相应连接且返回一个错误。

OLE DB 编程密码过期

SQL Server Native Client OLE DB 访问接口支持通过添加已添加到 DBPROPSET_SQLSERVERDBINIT 属性集的 SSPROP_AUTH_OLD_PASSWORD(类型 VT_BSTR)属性来处理密码过期。

现有“密码”属性是指 DBPROP_AUTH_PASSWORD,用于存储新密码。

注意注意

在连接字符串中,“旧密码”属性会设置 SSPROP_AUTH_OLD_PASSWORD,它是当前(有可能是过期的)密码,通过提供程序字符串属性无法得到该密码。

访问接口不保留此属性的值。如果设置此属性,则访问接口不使用连接池进行首次连接,原因是将进行新连接。如果密码更改成功,则不能重新使用当前连接,原因是当前连接仍包含旧密码,这些密码在密码更改后失效。此外,如果登录成功,则访问接口将清除此属性。如果随后尝试检索旧密码,则将返回 VT_EMPTY。

注意注意

不得保留 SSPROP_AUTH_OLD_PASSWORD,因为只有在密码过期时才使用它。

请注意,只要设置“旧密码”属性,访问接口就会假定正在尝试更改密码,除非还指定了 Windows 身份验证,这种情况下 Windows 身份验证始终优先。

如果使用 Windows 身份验证,则指定旧密码会产生 DB_E_ERRORSOCCURRED 或 DB_S_ERRORSOCCURRED(具体取决于是将旧密码指定为 REQUIRED 还是 OPTIONAL),并且在 dwStatus 中返回 DBPROPSTATUS_CONFLICTINGBADVALUE 的状态值。这将在调用 IDBInitialize::Initialize 时检测。

如果更改密码的尝试意外失败,则服务器将返回错误代码 18468。将从连接尝试返回标准的 OLEDB 错误。

有关 DBPROPSET_SQLSERVERDBINIT 属性集的详细信息,请参阅初始化和授权属性

SQL Server Native Client ODBC 驱动程序

SQL Server Native Client OLE DB 访问接口支持通过用户界面以及以编程方式处理密码过期。

ODBC 用户界面密码过期

SQL Server Native Client ODBC 驱动程序支持通过对**“SQL Server 登录名”**对话框进行更改来处理密码过期。

如果调用 SQLDriverConnect 并将 DriverCompletion 的值设置为 SQL_DRIVER_NOPROMPT,则在密码已过期的情况下初始连接尝试将失败。通过对 SQLErrorSQLGetDiagRec 进行后续调用返回 SQLSTATE 值 28000 和本机错误代码值 18487。

如果 DriverCompletion 已设置为任何其他值,则无论密码是否已过期,用户都会看到**“SQL Server 登录名”对话框。用户可单击“选项”按钮并选中“更改密码”**来更改密码。

如果用户单击“确定”且密码已过期,则 SQL Server 会提示使用**“更改 SQL Server 密码”**对话框输入并确认新密码。

ODBC 提示行为和锁定的帐户

连接尝试可能会由于帐户被锁定而失败。如果在显示**“SQL Server 登录名”对话框之后发生这种情况,则将向用户显示服务器错误消息,并且连接尝试将中止。如果在显示“更改 SQL Server 密码”**对话框后用户输入错误的旧密码值,则也会出现这种情况。在这种情况下,将显示相同的错误消息,并且连接尝试将中止。

ODBC 连接池、密码过期和锁定的帐户

当连接在连接池中仍处于活动状态时,帐户可能被锁定或其密码可能已过期。服务器会在以下两种情况下检查密码是否已过期以及帐户是否已锁定。第一种情况是首次创建连接时。第二种情况是从相应池中获取相应连接以重置连接时。

如果重置尝试失败,则将从相应池中删除相应连接且返回一个错误。

ODBC 编程密码过期

SQL Server Native Client ODBC 驱动程序支持通过添加使用 SQLSetConnectAttr 函数在连接到服务器之前设置的 SQL_COPT_SS_OLDPWD 属性来处理密码过期。

连接句柄的 SQL_COPT_SS_OLDPWD 属性是指已过期的密码。对于此属性,没有连接字符串属性,原因是如果有的话会影响连接池。如果登录成功,则驱动程序将清除此属性。

在以下四种情况下,SQL Server Native Client ODBC 驱动程序会为此功能返回 SQL_ERROR:密码过期、密码策略冲突、帐户锁定以及在使用 Windows 身份验证的情况下设置旧密码属性。调用 SQLGetDiagField 时,驱动程序会向用户返回相应的错误消息。

请参阅

其他资源