아티클
09/27/2010

CertProperty(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는 정수입니다.
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