CERTPROPERTY (Transact-SQL)

Artigo
06/18/2013

Retorna o valor de uma propriedade de certificado especificada.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

CertProperty ( Cert_ID , '<PropertyName>' )

<PropertyName> ::=
   Expiry_Date | Start_Date | Issuer_Name 
   | Cert_Serial_Number | Subject | SID | String_SID

Argumentos

Cert_ID
É a ID do certificado. Cert_ID é um inteiro.
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 SID do certificado. Também é o SID de qualquer logon ou usuário mapeado para esse certificado.
String_SID
É o SID do certificado como uma cadeia de caracteres. Também é o SID de qualquer logon ou usuário mapeado para o certificado.

Tipos de retorno

A especificação de propriedade deve ser incluída entre aspas simples.

O tipo de retorno depende da propriedade especificada na chamada de função. Todos os valores de retorno são encapsulados no tipo de retorno de sql_variant.

Expiry_Date e Start_Date retornam datetime.
Cert_Serial_Number, Issuer_Name, Subject e String_SID retornam nvarchar.
SID retorna varbinary.

Comentários

As informações sobre certificados são visíveis na exibição do catálogo sys.certificates.

Permissões

Requer algumas permissões no certificado e que a permissão VIEW DEFINITION não seja negada ao chamador no certificado.

Exemplos

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/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