CERTPROPERTY (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Retorna o valor de uma propriedade de certificado especificada.

Transact-SQL convenções de sintaxe

Syntax

CertProperty ( Cert_ID , '<PropertyName>' )  
  
<PropertyName> ::=  
   Expiry_Date | Start_Date | Issuer_Name   
   | Cert_Serial_Number | Subject | SID | String_SID   

Arguments

Cert_ID
O valor ID do certificado, do tipo de dados int.

Expiry_Date
A data de expiração do certificado.

Start_Date
A data em que o certificado se torna válido.

Issuer_Name
O nome do emissor do certificado.

Cert_Serial_Number
O número de série do certificado.

Subject
O assunto do certificado.

SID
O certificado SID. Este também é o SID de qualquer login ou usuário mapeado para este certificado.

String_SID
O SID do certificado como uma cadeia de caracteres. Este também é o SID de qualquer login ou usuário mapeado para o certificado.

Tipos de devolução

As aspas simples devem incluir a especificação da propriedade.

O tipo de retorno depende da propriedade especificada na chamada de função. O tipo de retorno sql_variant encapsula todos os valores de retorno.

• Expiry_Date e Start_Datedatetime de retorno.
• Cert_Serial_Number, Issuer_Name, String_SID e Subject todos retornam nvarchar.
• SID retorna varbinary.

Remarks

Consulte as informações do certificado na exibição do catálogo sys.certificates .

Permissions

Requer a(s) permissão(ões) apropriada(s) no certificado e requer que não tenha sido negada ao chamador a permissão VIEW no certificado. Consulte CREATE CERTIFICATE (Transact-SQL) e GRANT CERTIFICATE PERMISSIONS (Transact-SQL) para obter mais informações sobre permissões de certificado.

Examples

O exemplo a seguir retorna o assunto do certificado.

-- First create a certificate.  
CREATE CERTIFICATE Marketing19 WITH   
    START_DATE = '04/04/2004' ,  
    EXPIRY_DATE = '07/07/2040' ,  
    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  

Consulte também

CRIAR CERTIFICADO (Transact-SQL)
CERTIFICADO ALTER (Transact-SQL)
CERT_ID (Transact-SQL)Hierarquia de criptografiasys.certificates (Transact-SQL)Exibições do catálogo de segurança (Transact-SQL)