CertProperty (Transact-SQL)
傳回指定憑證屬性的值。
.gif "主題連結圖示")
語法
CertProperty ( Cert_ID , '<PropertyName>' )
<PropertyName> ::=
Expiry_Date | Start_Date | Issuer_Name
| Cert_Serial_Number | Subject | SID | String_SID
引數
- Cert_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)