ALTER CRYPTOGRAPHIC PROVIDER (Transact-SQL)

项目
06/18/2013

通过可扩展密钥管理 (EKM) 提供程序更改 SQL Server 中的加密提供程序。

语法

ALTER CRYPTOGRAPHIC PROVIDER provider_name 
    [ FROM FILE = path_of_DLL ]
    ENABLE | DISABLE

参数

provider_name
可扩展密钥管理提供程序的名称。
Path_of_DLL
实现 SQL Server 可扩展密钥管理接口的 .dll 文件的路径。
ENABLE | DISABLE
启用或禁用某个提供程序。

注释

如果提供程序更改了用于在 SQL Server 中实现可扩展密钥管理的 .dll 文件，则您必须使用 ALTER CRYPTOGRAPHIC PROVIDER 语句。

使用 ALTER CRYPTOGRAPHIC PROVIDER 语句更新 .dll 文件路径时，SQL Server 将执行以下操作：

禁用该提供程序。
验证 DLL 签名并确保该 .dll 文件的 GUID 与目录中记录的 GUID 相同。
更新目录中的 DLL 版本。

当 EKM 提供程序设置为 DISABLE 时，新连接上任何要将该提供程序用于加密语句的尝试都将失败。

若要禁用某个提供程序，必须终止使用该提供程序的所有会话。

当 EKM 提供程序 dll 未实现所需的所有方法时，ALTER CRYPTOGRAPHIC PROVIDER 可能会返回错误 33085：

One or more methods cannot be found in cryptographic provider library '%.*ls'.

如果用于创建 EKM 提供程序 dll 的标头文件过期，ALTER CRYPTOGRAPHIC PROVIDER 可能会返回错误 33032：

SQL Crypto API version '%02d. %02d' implemented by provider is not supported. Supported version is '%02d. %02d'.

权限

要求具有加密提供程序的 CONTROL 权限。

示例

下例将 SQL Server 中一个名为 SecurityProvider 的加密提供程序更改为更新版本的 .dll 文件。该新版本名为 c:\SecurityProvider\SecurityProvider_v2.dll 并且安装在服务器上。服务器上必须安装有该提供程序的证书。

/* First, disable the provider to perform the upgrade.
This will terminate all open cryptographic sessions */
ALTER CRYPTOGRAPHIC PROVIDER SecurityProvider 
DISABLE;
GO

/* Upgrade the provider .dll file. The GUID must the same
as the previous version, but the version can be different. */
ALTER CRYPTOGRAPHIC PROVIDER SecurityProvider
FROM FILE = 'c:\SecurityProvider\SecurityProvider_v2.dll';
GO

/* Enable the upgraded provider. */
ALTER CRYPTOGRAPHIC PROVIDER SecurityProvider 
ENABLE;
GO