CertProperty (Transact-SQL)

語法

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

請參閱

參考