CERTPROPERTY (Transact-SQL)

项目
06/18/2013

返回指定证书属性的值。

语法

CertProperty ( Cert_ID , '<PropertyName>' )

<PropertyName> ::=
   Expiry_Date | Start_Date | Issuer_Name 
   | Cert_Serial_Number | Subject | SID | String_SID

参数

Cert_ID
证书的 ID。 Cert_ID 的数据类型为 int。
Expiry_Date
证书的失效日期。
Start_Date
证书开始生效的日期。
Issuer_Name
证书颁发者的名称。
Cert_Serial_Number
证书序列号。
Subject
证书的主题。
SID
证书的 SID。这也是映射到该证书的所有登录或用户的 SID。
String_SID
字符串形式的证书的 SID。这也是映射到该证书的所有登录或用户的 SID。

返回类型

属性规范必须以单引号 (') 括起。

返回类型取决于在函数调用中指定的属性。所有的返回值都包装在 sql_variant 返回类型中。

Expiry_Date 和 Start_Date 返回 datetime。
Cert_Serial_Number、Issuer_Name、Subject 和 String_SID 返回 nvarchar。
SID 返回 varbinary。

注释

可在 sys.certificates 目录视图中查阅证书的有关信息。

权限

需要对证书具有某些权限，并且未拒绝向调用方授予该证书的 VIEW DEFINITION 权限。

示例

以下示例返回证书主题。

-- First create a certificate.
CREATE CERTIFICATE Marketing19 WITH 
    START_DATE = '04/04/2004' ,
    EXPIRY_DATE = '07/07/2007' ,
    SUBJECT = 'Marketing Print Division';
GO

-- Now use CertProperty to examine certificate
-- Marketing19's properties.
DECLARE @CertSubject sql_variant;
set @CertSubject = CertProperty( Cert_ID('Marketing19'), 'Subject');
PRINT CONVERT(nvarchar, @CertSubject);
GO