CertProperty (Transact-SQL)
返回指定证书属性的值。
.gif "主题链接图标")
语法
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)