CERTPROPERTY (Transact-SQL)

返回指定证书属性的值。

主题链接图标 Transact-SQL 语法约定

语法

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

请参阅

参考

CREATE CERTIFICATE (Transact-SQL)

ALTER CERTIFICATE (Transact-SQL)

CERT_ID (Transact-SQL)

sys.certificates (Transact-SQL)

安全性目录视图 (Transact-SQL)

概念

加密层次结构